English Français العربية

io.github.daedalus/mcp-smart-proxy

Official registry Other

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

Source code Documentation

Install

Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).

PYPI package mcp-smart-proxy
Claude Code 
claude mcp add mcp-smart-proxy -- uvx mcp-smart-proxy==0.1.1
JSON configuration (Claude Desktop, Cursor, VS Code) 
{
    "mcpServers": {
        "mcp-smart-proxy": {
            "command": "uvx",
            "args": [
                "mcp-smart-proxy==0.1.1"
            ]
        }
    }
}

Documentation

From the project's README on GitHub, refreshed weekly. Links open on GitHub.

Contents
  1. MCPSmartProxy
  2. Install
  3. Usage
  4. CLI
  5. API
  6. Development

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 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

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/

Frequently asked questions

What is io.github.daedalus/mcp-smart-proxy?

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

How do I install io.github.daedalus/mcp-smart-proxy?

It runs on your machine. In Claude Code: claude mcp add mcp-smart-proxy -- uvx mcp-smart-proxy==0.1.1. For other clients, paste the JSON configuration from this page into their MCP settings.

Does io.github.daedalus/mcp-smart-proxy need an API key?

Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.

Is io.github.daedalus/mcp-smart-proxy open source?

Yes. Its code is on GitHub under the MIT license.

Who maintains io.github.daedalus/mcp-smart-proxy?

It is published by daedalus. AI.tn lists it but does not maintain or endorse it.

From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.