MCP Registry

MCP Registry 為 MCP 客戶端提供服務器列表,就像 MCP 服務器的應用商店一樣。它是公開可用的 MCP 服務器的權威存儲庫

Registry 現已上線! 🎉
官方 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
  • 📦 包信息:下載位置(npmpypidocker 等)
  • ⚙️ 運行時信息:執行方式(參數、環境變量)
  • 📝 元數據:描述、功能、版本

部署方式

📦 包部署

發佈到註冊中心(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 遵循以下核心設計原則:

  1. 🎯 單一真實來源:公開可用 MCP 服務器的權威元數據存儲庫
  2. ⚖️ 供應商中立:不偏向特定服務器或組織
  3. 🔒 行業安全標準:利用現有包註冊中心的安全性
  4. 🔧 可重用性:API 形狀設計為可重用,支持私有/內部註冊中心
  5. 📈 漸進增強:從 MVP 開始,為未來功能構建基礎

社區和貢獻

協作渠道

核心維護者

下一步

快速導航

預覽版注意事項
當前 Registry 處於預覽階段,可能發生破壞性更改或數據重置。正式版本將稍後發佈。