MetaMCP

MetaMCP 是 MCP 聚合器/编排器/中间件/网关一体化平台。将多个 MCP 服务器动态聚合为统一的 MCP 端点，支持命名空间分组、中间件、工具覆盖、认证鉴权、流量控制等，本身也是一个 MCP 服务器，可接入任意 MCP 客户端。

核心功能

• MCP 服务器聚合与命名空间：将多个 MCP 服务器分组到命名空间，按命名空间发布为统一端点(SSE/Streamable HTTP/OpenAPI)，一键切换
• 工具级精细控制：按工具启用/禁用、覆盖工具名称/标题/描述、添加 MCP 注解(如 readOnlyHint)
• 中间件系统：请求/响应拦截与转换，内置"过滤非活跃工具"中间件，可扩展日志/错误追踪/验证/安全扫描
• 企业级安全与管控：API Key 认证、OAuth 2.0/OIDC 支持、注册控制、速率限制、CORS 策略
• 内置 Inspector：带保存服务器配置的 MCP 调试检查器，方便开发和测试
• 冷启动优化：预分配空闲会话减少冷启动延迟，Docker 自定义依赖安装

适用场景

• 将分散的 MCP 服务器统一管理为单一端点，简化客户端配置
• 为团队/企业托管动态组合的 MCP 服务，提供认证和访问控制
• 在 MCP 请求链路上应用可观测性、安全审计等中间件
• 按场景精选工具集（remix），优化 LLM 工具上下文窗口
• 作为 MCP 基础设施层，在其上构建自定义 AI Agent 平台
• 开发环境中统一管理和调试多个 MCP 服务器

安装方式

前置要求：Docker、Docker Compose

git clone https://github.com/metatool-ai/metamcp.git
cd metamcp
cp example.env .env  # 配置环境变量
docker compose up -d

SSE 端点配置（MCP客户端）：

{
  "url": "http://localhost:12008/metamcp/<ENDPOINT_NAME>/sse"
}

stdio 代理模式（配合 mcp-proxy）：

{
  "command": "uvx",
  "args": ["mcp-proxy", "--transport", "streamablehttp", "http://localhost:12008/metamcp/<ENDPOINT_NAME>/mcp"],
  "env": { "API_ACCESS_TOKEN": "<YOUR_API_KEY>" }
}

许可证：MIT