MCP Smart Proxy

Official

by daedalus · Python

An MCP server that provides a smart proxy to other mcp servers

Routes requests to other MCP servers through a smart proxy layer.

Topics

mcpmcp-clientmcp-proxy-servermcp-servercosine-similaritycontext-management

README.md2 KBView on GitHub

MCPSmartProxy

Token-efficient MCP server gateway with semantic tool search

mcp-name: io.github.daedalus/mcp-smart-proxy

Install

bash

pip install mcp-smart-proxy

Usage

python

from mcp_smart_proxy import ProxyConfig

config = ProxyConfig.from_file("proxy.yaml")

CLI

bash

mcp-smart-proxy --help
mcp-smart-proxy serve --config proxy.yaml
mcp-smart-proxy serve --config proxy.yaml --watch ./servers/
mcp-smart-proxy serve --config proxy.yaml --transport streamable-http --host 0.0.0.0 --port 8000
mcp-smart-proxy index --config proxy.yaml
mcp-smart-proxy status --config proxy.yaml
mcp-smart-proxy validate --config proxy.yaml

The --watch option monitors a directory for .yaml, .yml, or .json files containing upstream server configurations. Add, modify, or remove files to dynamically update the available servers at runtime.

Transport Options

The --transport option supports:

stdio (default) - Standard input/output transport for local MCP clients

API

Config

ProxyConfig - Main configuration model
UpstreamConfig - Upstream server configuration
EmbeddingConfig - Embedding backend configuration
VectorStoreConfig - Vector store backend configuration

Models

ListResult - Result from the list tool
SearchResult - Result from the search tool
ToolResult - Result from tool calls

Development

bash

git clone https://github.com/daedalus/mcp-smart-proxy.git
cd mcp-smart-proxy
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/

Install

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "mcp-smart-proxy": {
      "command": "uvx",
      "args": [
        "mcp-smart-proxy"
      ]
    }
  }
}