mcp-central

mcp-central

MCP aggregator - connect to multiple MCP servers through a single endpoint.

┌──────────────────┐      ┌─────────────────────────────────────┐
│  Claude Desktop  │      │            mcp-central              │
│  Cursor          │─────▶│                                     │
│  Any MCP Client  │      │   ┌──────┐  ┌─────┐  ┌─────┐        │
└──────────────────┘      │   │github│  │slack│  │ fs  │  ...   │
                          │   └──────┘  └─────┘  └─────┘        │
                          └─────────────────────────────────────┘

Install

npm install -g mcp-central

Or run directly with npx:

npx mcp-central --help

Usage

# Add MCP servers
mcp-central add github npx -y @modelcontextprotocol/server-github
mcp-central add fs npx -y @modelcontextprotocol/server-filesystem /tmp

# List configured servers
mcp-central list

# Remove a server
mcp-central remove github

Connect

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "bridge": {
      "command": "npx",
      "args": ["mcp-central", "serve"]
    }
  }
}

HTTP daemon (for apps):

mcp-central daemon -p 3000

Logs

View tool usage history:

mcp-central logs           # last 20 entries
mcp-central logs -n 50     # last 50 entries
mcp-central logs --all     # full history
mcp-central logs -f        # live tail (follow)

Output:

─── 4 log entries ───

Feb 3 23:37:11 ✓ github/create_issue 234ms {"title":"Test"}
Feb 3 23:37:11 ✓ fs/read_file 12ms {"path":"/tmp/test.txt"}
Feb 3 23:37:11 ✗ slack/send_message 1.5s {"channel":"#general"}
         └─ Channel not found
Feb 3 23:37:11 ✓ github/list_repos 892ms

Logs auto-rotate at 5000 entries to prevent disk bloat.

Tool Namespacing

Tools are prefixed with the MCP name:

github  + create_issue  →  github__create_issue
fs      + read_file     →  fs__read_file
slack   + send_message  →  slack__send_message

Config

Stored at:

• macOS: ~/Library/Application Support/mcp-central/config.json
• Linux: ~/.config/mcp-central/config.json

{
  "settings": {
    "logLevel": "info",
    "daemonPort": 3000
  },
  "servers": [
    {
      "name": "github",
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-github"],
      "env": {},
      "enabled": true
    }
  ]
}

Architecture

                    ┌─────────────────┐
                    │   MCP Client    │
                    └────────┬────────┘
                             │ stdio/http
                             ▼
┌───────────────────────────────────────────────────┐
│                    mcp-central                    │
│  ┌──────────┐    ┌────────────┐    ┌───────────┐  │
│  │  Server  │───▶│   Router   │───▶│  Manager  │  │
│  │stdio/http│    │            │    │           │  │
│  └──────────┘    └────────────┘    └─────┬─────┘  │
│                                          │        │
│                    ┌─────────────────────┼────┐   │
│                    ▼           ▼         ▼    │   │
│                 ┌─────┐    ┌─────┐    ┌─────┐ │   │
│                 │ MCP │    │ MCP │    │ MCP │ │   │
│                 │  1  │    │  2  │    │  3  │ │   │
│                 └─────┘    └─────┘    └─────┘ │   │
│                    stdio connections          │   │
└───────────────────────────────────────────────────┘

Future Improvements

• Resources/Prompts - Aggregate resources/list and prompts/list from MCPs
• Auto-reconnect - Reconnect to MCPs that fail or disconnect
• Tool filtering - Allow/block specific tools per MCP
• Environment variables - CLI support for --env KEY=VALUE
• Enable/disable - Toggle servers without removing them
• SSE transport - Connect to remote MCPs over HTTP/SSE
• Mac app - Native SwiftUI frontend using daemon as backend
• Metrics dashboard - Call counts, error rates, latencies

License

MIT