mcp-config-manager 1.0.6 → 1.0.8

package/README.md

@@ -63,70 +63,56 @@ npm link
 
 ```bash
 # List all clients and their status
-mcp-manager list
+mcp-config-manager list
 
 # Show servers for a specific client
-mcp-manager show claude
+mcp-config-manager show claude
 
 # Add a new server
-mcp-manager add claude my-server -c npx -a "-y" "@example/server" -e API_KEY=abc123
+mcp-config-manager add claude my-server -c npx -a "-y" "@example/server" -e API_KEY=abc123
 
 # Remove a server from one client
-mcp-manager remove claude my-server
+mcp-config-manager remove claude my-server
 
 # Remove a server from ALL clients
-mcp-manager remove all my-server
+mcp-config-manager remove all my-server
 
 # Copy server between clients
-mcp-manager copy claude my-server cursor
+mcp-config-manager copy claude my-server cursor
 
 # Copy server to ALL other clients
-mcp-manager copy claude my-server all
+mcp-config-manager copy claude my-server all
 
 # Manage environment variables
-mcp-manager env claude my-server set API_KEY new-value
-mcp-manager env claude my-server unset API_KEY
-mcp-manager env claude my-server list
+mcp-config-manager env claude my-server set API_KEY new-value
+mcp-config-manager env claude my-server unset API_KEY
+mcp-config-manager env claude my-server list
 
 # Export/Import configurations
-mcp-manager export claude config.json
-mcp-manager export claude --server my-server server-config.json
-mcp-manager import cursor config.json
+mcp-config-manager export claude config.json
+mcp-config-manager export claude --server my-server server-config.json
+mcp-config-manager import cursor config.json
 
 # Start web UI
-mcp-manager web
+mcp-config-manager web
 # or
 npm run web
 ```
 
-### Web UI
-
-#### Development (when cloning repository)
-```bash
-npm run web
-```
-
-#### Global Installation
-After installing globally with `npm install -g mcp-config-manager`:
+**Note:** `mcp-manager` also works as a shorter alias for `mcp-config-manager`.
 
-**Start web server in foreground:**
-```bash
-mcp-config-manager web --port 3456
-```
+### Web UI
 
-**Start web server as background daemon:**
+**Start the web server:**
 ```bash
-mcp-config-manager start --port 3456
-```
+# If installed globally
+mcp-config-manager web
 
-**Check daemon status:**
-```bash
-mcp-config-manager status
-```
+# If running from cloned repository
+npm run web
 
-**Stop daemon:**
-```bash
-mcp-config-manager stop
+# Custom port (default is 3456)
+PORT=3457 npm run web
 ```
 
 Then open http://localhost:3456 in your browser.
@@ -163,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`
@@ -171,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": {
@@ -191,12 +178,54 @@ 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.
 
 ## Development & Testing
 
+### Development Workflow
+
+**Complete workflow for changes:**
+```bash
+# 1. Make your changes to the code
+
+# 2. Run tests to verify everything works
+npm test
+
+# 3. Update README.md with any new features or changes
+
+# 4. Commit changes
+git add .
+git commit -m "feat: Your feature description
+
+- Detailed changes
+- Tests: 17/17 CLI ✅, 2/2 UI ✅
+
+🤖 Generated with [Claude Code](https://claude.ai/code)
+
+Co-Authored-By: Claude <noreply@anthropic.com>"
+
+# 5. Push to repository
+git push
+
+# 6. Publish to npm (maintainers only)
+npm version patch  # or minor/major
+npm publish
+```
+
 ### Running Tests
 
 The project includes comprehensive test coverage:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mcp-config-manager",
-  "version": "1.0.6",
+  "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));
+    }
   }