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.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →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
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →