mcp-config-manager 1.0.7 → 1.0.8

package/README.md

@@ -149,7 +149,7 @@ This tool supports auto-detection of any client that follows the Model Context P
 
 - **Amazon Q Developer**: `~/.aws/amazonq/mcp.json`
 - **Claude Desktop**: `~/Library/Application Support/Claude/claude_desktop_config.json`
-- **Claude Code**: `.mcp.json` in project root
+- **Claude Code**: `~/.claude.json` (global settings and MCP servers)
 - **Cline**: `~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json`
 - **Cursor**: `.cursor/mcp.json` (project-specific) or `~/.cursor/mcp.json` (global)
 - **Factory Bridge**: `~/Library/Application Support/Factory Bridge/mcp.json`
@@ -157,12 +157,13 @@ This tool supports auto-detection of any client that follows the Model Context P
 - **Roo Code**: `~/Library/Application Support/Code/User/globalStorage/rooveterinaryinc.roo-cline/settings/cline_mcp_settings.json`
 - **VS Code**: `.vscode/mcp.json`
 - **Windsurf**: `~/.codeium/windsurf/mcp_config.json` or `~/AppData/Roaming/WindSurf/mcp_settings.json` (Windows)
+ - **Codex**: `~/.codex/config.toml` (TOML with `[mcp_servers.<name>]` tables)
 
 *Note: Paths may vary based on your operating system. The tool will attempt to find the correct path automatically.*
 
 ## Configuration Format
 
-Standard MCP server configuration:
+Standard MCP server configuration (JSON-based clients like Claude Desktop, Claude Code, Cursor, VS Code, etc.):
 ```json
 {
   "mcpServers": {
@@ -177,6 +178,18 @@ Standard MCP server configuration:
 }
 ```
 
+Codex uses a TOML configuration file at `~/.codex/config.toml`, where MCP servers are defined under the `[mcp_servers.<server-name>]` tables. For example:
+
+```toml
+[mcp_servers.context7]
+command = "npx"
+args = ["-y", "@upstash/context7-mcp"]
+
+[mcp_servers.figma]
+url = "https://mcp.figma.com/mcp"
+bearer_token_env_var = "FIGMA_OAUTH_TOKEN"
+```
+
 ## Security Note
 
 Environment variables may contain sensitive data like API keys. The tool masks values containing "KEY" or "SECRET" in the display but stores them in plain text in config files.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-config-manager",
-  "version": "1.0.7",
+  "version": "1.0.8",
   "description": "Simple CLI and web UI to manage MCP configs across multiple AI clients",
   "main": "src/cli.js",
   "bin": {
@@ -40,6 +40,7 @@
   ],
   "type": "module",
   "dependencies": {
+    "@iarna/toml": "^3.0.0",
     "commander": "^14.0.1",
     "cors": "^2.8.5",
     "express": "^5.1.0"

package/src/claude-client.js

@@ -0,0 +1,35 @@
+import fs from 'fs/promises';
+import path from 'path';
+import os from 'os';
+
+async function getProjectConfig(projectPath) {
+  const configPath = path.join(projectPath, '.mcp.json');
+  try {
+    const content = await fs.readFile(configPath, 'utf-8');
+    return JSON.parse(content);
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      return null; // File not found
+    }
+    throw error;
+  }
+}
+
+async function getUserConfig() {
+  const homeDir = os.homedir();
+  const configPath = path.join(homeDir, '.mcp.json');
+  try {
+    const content = await fs.readFile(configPath, 'utf-8');
+    return JSON.parse(content);
+  } catch (error) {
+    if (error.code === 'ENOENT') {
+      return null; // File not found
+    }
+    throw error;
+  }
+}
+
+export {
+  getProjectConfig,
+  getUserConfig,
+};

package/src/clients.js

@@ -14,9 +14,9 @@ export const CLIENTS = {
   'claude-code': {
     name: 'Claude Code',
     configPaths: {
-      darwin: '.mcp.json',
-      win32: '.mcp.json',
-      linux: '.mcp.json'
+      darwin: path.join(os.homedir(), '.claude.json'),
+      win32: path.join(os.homedir(), '.claude.json'),
+      linux: path.join(os.homedir(), '.claude.json')
     },
     format: 'mcpServers'
   },
@@ -74,6 +74,15 @@ export const CLIENTS = {
     },
     format: 'mcpServers'
   },
+  codex: {
+    name: 'Codex',
+    configPaths: {
+      darwin: path.join(os.homedir(), '.codex/config.toml'),
+      win32: path.join(os.homedir(), '.codex/config.toml'),
+      linux: path.join(os.homedir(), '.codex/config.toml')
+    },
+    format: 'codex'
+  },
   '5ire': {
     name: '5ire',
     configPaths: {

package/src/config-manager.js

@@ -1,6 +1,7 @@
 import * as fs from 'fs/promises';
 import path from 'path';
 import os from 'os';
+import TOML from '@iarna/toml';
 
 import { CLIENTS as PROD_CLIENTS } from './clients.js';
 
@@ -223,11 +224,15 @@ export class MCPConfigManager {
     const configPath = await this.getConfigPath(client);
     let clientConfig = { servers: {} };
 
+    const clients = await this.getClients();
+    const clientInfo = clients[client];
+
     try {
       const content = await fs.readFile(configPath, 'utf-8');
-      const parsedContent = JSON.parse(content);
-      const clients = await this.getClients();
-      clientConfig = this.normalizeConfig(parsedContent, clients[client].format);
+      const parsedContent = clientInfo.format === 'codex'
+        ? TOML.parse(content)
+        : JSON.parse(content);
+      clientConfig = this.normalizeConfig(parsedContent, clientInfo.format);
     } catch (error) {
       if (error.code !== 'ENOENT') {
         throw error;
@@ -251,6 +256,9 @@ export class MCPConfigManager {
       return { servers: config.mcpServers || {} };
     } else if (format === 'mcp.servers') {
       return { servers: config.mcp?.servers || {} };
+    } else if (format === 'codex') {
+      // Codex stores MCP servers under [mcp_servers.<server-name>] tables in config.toml
+      return { servers: config.mcp_servers || {} };
     }
     return { servers: {} };
   }
@@ -266,6 +274,15 @@ export class MCPConfigManager {
           servers: normalizedConfig.servers
         }
       };
+    } else if (format === 'codex') {
+      // Preserve other Codex settings and update only the mcp_servers table
+      return {
+        ...originalConfig,
+        mcp_servers: {
+          ...(originalConfig.mcp_servers || {}),
+          ...normalizedConfig.servers
+        }
+      };
     }
     return originalConfig;
   }
@@ -278,7 +295,9 @@ export class MCPConfigManager {
     let originalConfig = {};
     try {
       const content = await fs.readFile(configPath, 'utf-8');
-      originalConfig = JSON.parse(content);
+      originalConfig = clientConfig.format === 'codex'
+        ? TOML.parse(content)
+        : JSON.parse(content);
     } catch (error) {
       // File doesn't exist, that's OK
     }
@@ -286,7 +305,12 @@ export class MCPConfigManager {
     const finalConfig = this.denormalizeConfig(config, clientConfig.format, originalConfig);
 
     await fs.mkdir(path.dirname(configPath), { recursive: true });
-    await fs.writeFile(configPath, JSON.stringify(finalConfig, null, 2));
+
+    if (clientConfig.format === 'codex') {
+      await fs.writeFile(configPath, TOML.stringify(finalConfig));
+    } else {
+      await fs.writeFile(configPath, JSON.stringify(finalConfig, null, 2));
+    }
   }