MCP Registry
MCP Registry 為 MCP 客戶端提供服務器列表,就像 MCP 服務器的應用商店一樣。它是公開可用的 MCP 服務器的權威存儲庫。
Registry 現已上線! 🎉
官方 MCP Registry 已於 2025 年 9 月 8 日發佈預覽版本。查看 發佈公告 瞭解詳情。
官方 MCP Registry 已於 2025 年 9 月 8 日發佈預覽版本。查看 發佈公告 瞭解詳情。
快速訪問
Registry 生態系統
MCP Registry 項目包含兩個核心部分:
🟦 MCP Registry 規範
一個 API 規範,允許任何人實現 Registry。
🟥 官方 MCP Registry
位於 registry.modelcontextprotocol.io 的託管 Registry,遵循 MCP Registry 規範。
特點:
- 📋 權威存儲庫:公開可用 MCP 服務器的統一數據源
- 🏛️ 社區所有:由 MCP 開源社區擁有,Anthropic、GitHub、PulseMCP、Microsoft 等可信貢獻者支持
- 🔍 統一發現:服務器創建者發佈一次,所有消費者引用相同的規範數據
Registry 的工作原理
元註冊中心概念
MCP Registry 是元註冊中心,它們託管包的元數據,但不託管包代碼或二進制文件。
graph TD
A[MCP Registry] -->|元數據| B[NPM Registry]
A -->|元數據| C[PyPI Registry]
A -->|元數據| D[Docker Hub]
A -->|元數據| E[GitHub Releases]
B -->|實際代碼| F[MCP 客戶端]
C -->|實際代碼| F
D -->|實際鏡像| F
E -->|實際文件| F
示例:
- MCP Registry: “weather-server v1.2.0 位於 npm:weather-mcp”
- NPM Registry: [實際的 weather-mcp 包代碼]
服務器表示格式
每個服務器條目使用標準化的 server.json 格式包含:
- 🆔 身份信息:唯一名稱(
io.github.user/server-name) - 📦 包信息:下載位置(
npm、pypi、docker等) - ⚙️ 運行時信息:執行方式(參數、環境變量)
- 📝 元數據:描述、功能、版本
部署方式
📦 包部署
發佈到註冊中心(npm、PyPI、NuGet、Docker Hub 等)並由客戶端本地運行。
支持的註冊中心:
- NPM: JavaScript/TypeScript 服務器
- PyPI: Python 服務器
- NuGet: .NET 服務器
- Docker Hub/GHCR: 容器化服務器
- MCPB: MCP Bundle 格式
- GitHub/GitLab Releases: 直接文件下載
🌐 遠程部署
作為 Web 服務託管,客戶端直接連接。
支持的傳輸協議:
- SSE (Server-Sent Events): 服務器推送事件
- Streamable HTTP: 流式 HTTP 連接
🔄 混合部署
同時提供包和遠程選項,實現最大靈活性。
身份驗證和命名空間
Registry 根據命名空間驗證所有權:
GitHub 命名空間 (io.github.username/*)
- 驗證方式:GitHub OAuth 或 GitHub Actions OIDC
- 適用於:開源項目、個人開發者
- 示例:
io.github.modelcontextprotocol/filesystem
域名命名空間 (com.yourcompany/*)
- 驗證方式:DNS 或 HTTP 域名驗證
- 適用於:企業、組織
- 示例:
com.anthropic/claude-tools
註冊中心架構
graph TB
subgraph "生態系統"
OR[官方 Registry]
SR1[子註冊中心 A]
SR2[子註冊中心 B]
SR3[企業 Registry]
end
subgraph "客戶端"
MC1[MCP 客戶端 1]
MC2[MCP 客戶端 2]
APP[第三方應用]
end
subgraph "發佈者"
PUB1[開發者 A]
PUB2[企業 B]
PUB3[開源項目]
end
OR -.ETL.-> SR1
OR -.ETL.-> SR2
SR1 --> MC1
SR2 --> MC2
SR3 --> APP
PUB1 --> OR
PUB2 --> OR
PUB3 --> OR
子註冊中心(Subregistries)
子註冊中心通過以下方式為 Registry 生態系統增加價值:
- 🎯 策展:為特定社區或用例過濾服務器
- ⭐ 評級:添加用戶評分和下載統計
- 🔒 安全:實施安全掃描和漏洞檢查
- 🏢 企業:為企業用戶提供內部服務器註冊
Registry API 快速參考
核心端點
GET /v0/servers- 列出所有服務器(分頁)GET /v0/servers/{id}- 按 UUID 獲取服務器詳情POST /v0/publish- 發佈新服務器(需要認證)
基礎示例
# 列出前 10 個服務器
curl "https://registry.modelcontextprotocol.io/v0/servers?limit=10"
# 搜索特定服務器
curl "https://registry.modelcontextprotocol.io/v0/servers?search=filesystem"
# 獲取特定服務器詳情
curl "https://registry.modelcontextprotocol.io/v0/servers/{server-id}"設計原則
MCP Registry 遵循以下核心設計原則:
- 🎯 單一真實來源:公開可用 MCP 服務器的權威元數據存儲庫
- ⚖️ 供應商中立:不偏向特定服務器或組織
- 🔒 行業安全標準:利用現有包註冊中心的安全性
- 🔧 可重用性:API 形狀設計為可重用,支持私有/內部註冊中心
- 📈 漸進增強:從 MVP 開始,為未來功能構建基礎
社區和貢獻
協作渠道
- Discord - 實時社區討論
- GitHub Discussions - 產品/技術需求討論
- GitHub Issues - 技術工作跟蹤
- Pull Requests - 代碼貢獻
核心維護者
- Adam Jones (Anthropic) @domdomegg
- Tadas Antanavicius (PulseMCP) @tadasant
- Toby Padilla (GitHub) @toby
下一步
學習如何將您的 MCP 服務器發佈到 Registry
瞭解如何在應用中使用 Registry API
掌握 Registry 命令行工具
設置自動化發佈工作流
查看常見問題解答
查看完整的 REST API 規範
快速導航
預覽版注意事項
當前 Registry 處於預覽階段,可能發生破壞性更改或數據重置。正式版本將稍後發佈。
當前 Registry 處於預覽階段,可能發生破壞性更改或數據重置。正式版本將稍後發佈。