Mcp Smart Proxy

io.github.daedalusPublished by GitHub account daedalusv0.1.1Updated Oct 24, 2026

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

VerifiedSTDIODesktop onlyDeveloper ToolsAI & ML

Overview

AI-generated overview

A local MCP gateway that proxies other MCP servers and exposes their tools through semantic search to save tokens.

What you can do
  • Aggregate multiple upstream MCP servers behind one proxy, configured from a YAML or JSON file
  • List and search upstream tools semantically, then call them through the proxy
  • Reload upstream server definitions at runtime by watching a directory of config files
  • Run as a local stdio server, or serve over streamable HTTP on a chosen host and port
  • Index, check status and validate the proxy configuration from the command line
When to use it
Useful when you connect to many MCP servers and want one entry point whose tool list stays small, with tools found by semantic search instead of loading every definition into context.
Requirements
Python package installed with pip. A proxy configuration file describing upstream servers, plus embedding and vector store backends for the semantic search. Runs as a local process; streamable HTTP mode needs a host and port.
Before you install
The proxy sits between the assistant and every upstream server, so it inherits their access and any credentials those servers use. Tool calls are forwarded to upstream servers and can change or delete data there. Config files in the watched directory are loaded automatically, so only point it at trusted files.

Installation

In SourceWeft

  1. Open Mcp Smart Proxy in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

MCPSmartProxy

Token-efficient MCP server gateway with semantic tool search

[PyPI] [Python] [Coverage] [Ruff]

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 --helpmcp-smart-proxy serve --config proxy.yamlmcp-smart-proxy serve --config proxy.yaml --watch ./servers/mcp-smart-proxy serve --config proxy.yaml --transport streamable-http --host 0.0.0.0 --port 8000mcp-smart-proxy index --config proxy.yamlmcp-smart-proxy status --config proxy.yamlmcp-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.gitcd mcp-smart-proxypip install -e ".[test]"
# run testspytest
# formatruff format src/ tests/
# lintruff check src/ tests/
# type checkmypy src/

Source: README.md at commit 06fa878

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.1LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts