ruler/src/paths/mcp.ts at main · intellectronica/ruler · GitHub

1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
import * as path from 'path';
import { promises as fs } from 'fs';

/** Determine the native MCP config path for a given agent. */
export async function getNativeMcpPath(
  adapterName: string,
  projectRoot: string,
): Promise<string | null> {
  const candidates: string[] = [];
  switch (adapterName) {
    case 'GitHub Copilot':
      candidates.push(path.join(projectRoot, '.vscode', 'mcp.json'));
      break;
    case 'Visual Studio':
      candidates.push(path.join(projectRoot, '.mcp.json'));
      candidates.push(path.join(projectRoot, '.vs', 'mcp.json'));
      break;
    case 'Cursor':
      candidates.push(path.join(projectRoot, '.cursor', 'mcp.json'));
      break;
    case 'Windsurf':
      candidates.push(path.join(projectRoot, '.windsurf', 'mcp_config.json'));
      break;
    case 'Claude Code':
      candidates.push(path.join(projectRoot, '.mcp.json'));
      break;
    case 'OpenAI Codex CLI':
      candidates.push(path.join(projectRoot, '.codex', 'config.toml'));
      break;
    case 'Aider':
      candidates.push(path.join(projectRoot, '.mcp.json'));
      break;
    case 'Open Hands':
      // For Open Hands, we target the main config file, not a separate mcp.json
      candidates.push(path.join(projectRoot, 'config.toml'));
      break;
    case 'Gemini CLI':
      candidates.push(path.join(projectRoot, '.gemini', 'settings.json'));
      break;
    case 'Junie':
      candidates.push(path.join(projectRoot, '.junie', 'mcp', 'mcp.json'));
      break;
    case 'Qwen Code':
      candidates.push(path.join(projectRoot, '.qwen', 'settings.json'));
      break;
    case 'Kilo Code':
      candidates.push(path.join(projectRoot, '.kilocode', 'mcp.json'));
      break;
    case 'Kiro':
      candidates.push(path.join(projectRoot, '.kiro', 'settings', 'mcp.json'));
      break;
    case 'OpenCode':
      candidates.push(path.join(projectRoot, 'opencode.json'));
      break;
    case 'Firebase Studio':
      candidates.push(path.join(projectRoot, '.idx', 'mcp.json'));
      break;
    case 'Factory Droid':
      candidates.push(path.join(projectRoot, '.factory', 'mcp.json'));
      break;
    case 'Zed':
      // Only consider project-local Zed settings (avoid writing to user home directory)
      candidates.push(path.join(projectRoot, '.zed', 'settings.json'));
      break;
    default:
      return null;
  }
  for (const p of candidates) {
    try {
      await fs.access(p);
      return p;
    } catch {
      // continue
    }
  }
  // default to first candidate if none exist
  return candidates.length > 0 ? candidates[0] : null;
}

/** Read native MCP config from disk, or return empty object if missing/invalid. */
export async function readNativeMcp(
  filePath: string,
): Promise<Record<string, unknown>> {
  try {
    const text = await fs.readFile(filePath, 'utf8');
    return JSON.parse(text) as Record<string, unknown>;
  } catch {
    return {};
  }
}

/** Write native MCP config to disk, creating parent directories as needed. */
export async function writeNativeMcp(
  filePath: string,
  data: unknown,
): Promise<void> {
  await fs.mkdir(path.dirname(filePath), { recursive: true });
  const text = JSON.stringify(data, null, 2) + '\n';
  await fs.writeFile(filePath, text, 'utf8');
}