proxy-mcp

Universal MCP proxy server that discovers, searches, and executes tools across all your configured MCP servers from a single entry point.

Features

• Proxy execution — Call any tool on any MCP server through execute_mcp_tool

• Semantic search — Find tools by describing what you want to do, not by exact name

• Connection pool — MCP subprocesses are spawned on-demand and reused across calls

• Weight learning — The search system learns from your selections to improve rankings over time

• Auto-indexing — All MCP tools are indexed on server startup (non-blocking)

Related MCP server: Multi MCP

Tools

Requirements

• Python >= 3.10

• uv (recommended) or pip

Installation

# Clone
git clone https://github.com/Rixmerz/proxy-mcp.git
cd proxy-mcp

# Install with uv
uv sync

Configuration

Add to ~/.claude.json under mcpServers:

{
  "mcpServers": {
    "proxy-mcp": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/proxy-mcp", "proxy-mcp"]
    }
  }
}

The proxy reads MCP server configs from:

1. ~/.agentcockpit/mcps.json (priority)

2. ~/.claude.json (fallback)

Usage examples

# Search for a tool by what you want to do
search_tools(query="expose service to internet")

# Execute a tool on a specific MCP
execute_mcp_tool(
    mcp_name="Context7",
    tool_name="get-library-docs",
    arguments={"context7CompatibleLibraryID": "/vercel/next.js", "topic": "routing"}
)

# List all available MCPs
list_available_mcps()

Data

Learned weights are stored at ~/.proxy-mcp/learned_weights.json.

License

MIT