Summary
Acts as a token-efficient gateway between Claude and multiple MCP servers by using semantic search to find relevant tools instead of loading everything upfront. You configure upstream servers in YAML, and it builds a vector index of their tool descriptions. When Claude needs something, it queries the index first, then proxies calls to the right server. Supports stdio transport out of the box, includes a watch mode for hot-reloading server configs from a directory, and lets you validate or inspect your setup via CLI commands. Reach for this when you're hitting context limits from too many tool definitions or want to aggregate tools from several MCP servers without overwhelming the model.
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →
Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →MCPSmartProxy
Token-efficient MCP server gateway with semantic tool search
mcp-name: io.github.daedalus/mcp-smart-proxy
Install
pip install mcp-smart-proxy
Usage
from mcp_smart_proxy import ProxyConfig
config = ProxyConfig.from_file("proxy.yaml")
CLI
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 modelUpstreamConfig- Upstream server configurationEmbeddingConfig- Embedding backend configurationVectorStoreConfig- Vector store backend configuration
Models
ListResult- Result from thelisttoolSearchResult- Result from thesearchtoolToolResult- Result from tool calls
Development
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/
Featured
Keeps your Mac awake while Claude Code, Codex or Cursor works. Lets it sleep when they are done.
Try free for 7 days →Block distracting apps from your iPhone permanently without a 3rd party app. Free and open source.
Block now (100% free) →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →