{
  "markdown": "# MCPSmartProxy\n\n> Token-efficient MCP server gateway with semantic tool search\n\n[![PyPI](https://img.shields.io/pypi/v/mcp-smart-proxy.svg)](https://pypi.org/project/mcp-smart-proxy/)\n[![Python](https://img.shields.io/pypi/pyversions/mcp-smart-proxy.svg)](https://pypi.org/project/mcp-smart-proxy/)\n[![Coverage](https://codecov.io/gh/daedalus/mcp-smart-proxy/branch/main/graph/badge.svg)](https://codecov.io/gh/daedalus/mcp-smart-proxy)\n[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)\n\nmcp-name: io.github.daedalus/mcp-smart-proxy\n\n## Install\n\n```bash\npip install mcp-smart-proxy\n```\n\n## Usage\n\n```python\nfrom mcp_smart_proxy import ProxyConfig\n\nconfig = ProxyConfig.from_file(\"proxy.yaml\")\n```\n\n## CLI\n\n```bash\nmcp-smart-proxy --help\nmcp-smart-proxy serve --config proxy.yaml\nmcp-smart-proxy serve --config proxy.yaml --watch ./servers/\nmcp-smart-proxy serve --config proxy.yaml --transport streamable-http --host 0.0.0.0 --port 8000\nmcp-smart-proxy index --config proxy.yaml\nmcp-smart-proxy status --config proxy.yaml\nmcp-smart-proxy validate --config proxy.yaml\n```\n\nThe `--watch` option monitors a directory for `.yaml`, `.yml`, or `.json` files containing\nupstream server configurations. Add, modify, or remove files to dynamically update the\navailable servers at runtime.\n\n### Transport Options\n\nThe `--transport` option supports:\n- `stdio` (default) - Standard input/output transport for local MCP clients\n\n## API\n\n### Config\n\n- `ProxyConfig` - Main configuration model\n- `UpstreamConfig` - Upstream server configuration\n- `EmbeddingConfig` - Embedding backend configuration\n- `VectorStoreConfig` - Vector store backend configuration\n\n### Models\n\n- `ListResult` - Result from the `list` tool\n- `SearchResult` - Result from the `search` tool\n- `ToolResult` - Result from tool calls\n\n## Development\n\n```bash\ngit clone https://github.com/daedalus/mcp-smart-proxy.git\ncd mcp-smart-proxy\npip install -e \".[test]\"\n\n# run tests\npytest\n\n# format\nruff format src/ tests/\n\n# lint\nruff check src/ tests/\n\n# type check\nmypy src/\n```\n",
  "bytes": 2138,
  "sha": "c8463ab5298e673195eb463957ef697a0ca49fb3888c9251dc8929b6d2a7544b",
  "repo_slug": "daedalus/mcp-smart-proxy",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_daedalus_mcp_smart_proxy_24c9136b/readme"
}