mcpx

🚀 MCP Compact

MCP Compact 可将多个上游 MCP 服务器聚合到一个仅支持标准输入输出（stdio）的运行时环境中，提供一个简洁统一的接口。

🚀 快速开始

从 MCP 客户端使用

MCP Compact 作为一个标准输入输出（stdio）的 MCP 服务器运行，它不暴露 HTTP 接口或 /mcp 路径。

你可以按如下方式配置 MCP 客户端来启动它：

{
  "mcpServers": {
    "mcp_compact": {
      "command": "uv",
      "args": ["run", "mcp-compact", "config.example.json"]
    }
  }
}

若要手动启动，可运行以下命令：

uv run mcp-compact config.example.json

上游配置

config.example.json 是 mcp-compact 自身使用的配置文件：

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/tmp"]
    }
  }
}

所有上游服务器必须使用标准输入输出（stdio）。

测试

uv run ruff check src/mcp_compact tests
uv run mypy src/mcp_compact
uv run pytest tests/ -q

✨ 主要特性

MCP Compact 作为一个 MCP 服务器通过标准输入输出（stdio）运行，仅暴露 invoke 和 read 接口。