Master MCP Server

🚀 主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文檔。

基礎用法

# 安裝（需要網絡）
npm i -D typedoc typedoc-plugin-markdown

高級用法

# 生成文檔
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

🔧 技術細節

📄 許可證

請參閱 LICENSE。此倉庫目前使用UNLICENSED許可證，僅供私有/內部使用。

貢獻與支持

• 開發工作流程和指南請參閱 docs/contributing/*
• 解決方案請參閱 docs/troubleshooting/index.md
• 如有需要或想法，請開啟一個issue或討論。