主MCP服务器

主MCP服务器通过单一安全端点聚合多个MCP服务器。它提供基于配置的模块加载、统一的能力发现、具有弹性的请求路由以及针对多后端认证的一流OAuth流程。

特点

• 聚合多个MCP服务器，支持工具/资源发现和命名空间
• 支持OAuth：主令牌传递、委托提供商流程、代理刷新
• 基于配置的设置，使用JSON/YAML，进行模式验证和密钥解析
• 弹性路由：负载均衡、带有退避/抖动的重试、断路器
• 跨平台：Node.js服务器和Cloudflare Workers运行时
• 生产就绪部署：Docker、Cloudflare Workers、Koyeb
• 测试策略和CI就绪结构

快速开始（Node.js）

1. 安装依赖项（需要网络）：

npm ci

2. 配置环境（复制并编辑）：

cp .env.example .env

3. 开发模式运行：

npm run dev

4. 健康检查和指标：

• GET /health → { ok: true }
• GET /metrics → 基本系统指标

5. MCP端点（HTTP网关）：

• POST /mcp/tools/list
• POST /mcp/tools/call 带有 { name, arguments }
• POST /mcp/resources/list
• POST /mcp/resources/read 带有 { uri }

详情参见 docs/ 中的完整指南和端到端示例。

文档

• 文档索引：docs/index.md
• 入门指南：docs/getting-started/overview.md
• 指南：docs/guides/*
• API参考：生成至 docs/api/reference/（详见下文）
• 配置参考：docs/configuration/*
• 部署：docs/deployment/*
• 故障排除：docs/troubleshooting/*
• 贡献：docs/contributing/*

生成API文档

我们使用TypeDoc（Markdown）从TypeScript生成API文档。

1. 安装（需要网络）：

npm i -D typedoc typedoc-plugin-markdown

2. 生成文档：

npm run docs:api

输出至 docs/api/。

示例

工作示例位于 examples/：

• 基本Node：examples/basic-node
• Cloudflare Worker：examples/cloudflare-worker
• 高级路由：examples/advanced-routing
• OAuth委托：examples/oauth-delegation
• 测试模式：参见 /tests 和 docs/examples/testing.md

每个示例都有一个包含运行指令的README。

部署

• Docker：deploy/docker/* 和顶级 Dockerfile / docker-compose.yml
• Cloudflare Workers：deploy/cloudflare/* 使用 wrangler.toml
• Koyeb：deploy/koyeb/koyeb.yaml
• CI/CD示例：参见 docs/deployment/cicd.md

架构

贡献与支持

• 参见 docs/contributing/* 获取开发工作流程和指南
• 参见 docs/troubleshooting/index.md 获取解决方案
• 打开问题或讨论以获取帮助和想法

许可证

参见 LICENSE。此仓库当前使用UNLICENSED用于私有/内部用途。