Registry 常見問題

MCP Registry 常見問題

這些問題在關於 MCP Registry 的討論中經常出現。如果您有這裡沒有解答的問題，請在 MCP Registry 討論頁面上開始討論。

一般問題

什麼是 MCP Registry？

MCP Registry 是公開可訪問的 MCP 服務器的官方集中式元數據存儲庫。它提供：

服務器創建者發佈其服務器元數據的單一場所
MCP 客戶端和聚合器發現可用服務器的 REST API
標準化的安裝和配置信息
通過 DNS 驗證的命名空間管理

“官方 MCP Registry”、“MCP Registry”、“MCP 註冊中心"等有什麼區別？

有四個基本概念：

“MCP 服務器註冊中心 API”（或"MCP Registry API”）：在 openapi.yaml 中定義的 OpenAPI 規範。這是一個可重用的 API 規範，任何構建"MCP 服務器註冊中心"的人都應該考慮採用/對齊。
“官方 MCP Registry”（或"MCP Registry"）：位於 https://registry.modelcontextprotocol.io 的應用程序。該註冊中心目前僅編目 MCP 服務器，但將來可能擴展到也編目 MCP 客戶端/主機應用程序和框架。
“官方 MCP Registry API”：在 https://registry.modelcontextprotocol.io 提供的 REST API，它是 MCP Registry API 的超集。
“MCP 服務器註冊中心”（或"MCP 註冊中心"）：第三方（可能是商業）實現的 MCP 服務器註冊中心 API 或衍生規範。

MCP Registry 是包註冊中心嗎？

不是。MCP Registry 存儲有關 MCP 服務器的元數據以及它們託管位置的引用（npm、PyPI、NuGet、Docker Hub 等），但不託管實際的源代碼或包。

誰應該直接使用 MCP Registry？

該註冊中心主要設計用於子註冊中心（Smithery、PulseMCP、Docker Hub、Anthropic、GitHub 等）的程序化消費。它目前不面向個人客戶端或最終用戶（他們應該使用子註冊中心）。

會有功能 X 嗎？

請參閱路線圖。

發佈服務器

如何發佈我的 MCP 服務器？

請參閱發佈指南。

有哪些可用的命名空間？

GitHub 驗證：io.github.yourusername/server-name、io.github.yourorg/server-name
DNS 驗證：com.yourcompany.*、com.yourcompany.*/*
HTTP 驗證：com.yourcompany/*

需要開源嗎？

不需要。雖然鼓勵開源代碼，但對於本地或遠程運行的服務器都不是必需的。

支持哪些包註冊中心？

npm（Node.js 包）
PyPI（Python 包）
NuGet.org（.NET 包）
GitHub Container Registry（GHCR）
Docker Hub
MCPB（MCP Bundle 格式）

社區可以根據需要添加更多；如果您有興趣為另一個註冊中心構建支持，請隨時提出問題。

可以發佈多個版本嗎？

可以，支持版本控制：

每個版本都有自己不可變的元數據
每個服務器的版本字符串必須唯一
舊版本保持可訪問以保持兼容性
註冊中心在可能的情況下基於語義版本排序跟蹤哪個版本是"最新的"

如何更新我的服務器元數據？

提交一個帶有唯一版本字符串的新 server.json。一旦發佈，版本元數據就是不可變的（類似於 npm）。

應該使用什麼版本格式？

註冊中心接受長度最多 255 個字符的任何版本字符串，但我們建議：

應該使用語義版本控制（例如，“1.0.2”、“2.1.0-alpha”）以獲得可預測的排序
應該與包版本對齊以減少混亂
可以使用預發佈標籤（例如，“1.0.0-1”）用於註冊中心特定版本

註冊中心嘗試將版本解析為語義版本以進行適當的排序。允許非語義版本，但將按發佈時間戳排序。版本範圍（例如，^1.2.3、~1.2.3、>=1.2.3、1.x、1.*）被拒絕；請發佈特定版本。詳細指導請參閱版本控制指南。

發佈時可以添加自定義元數據嗎？

可以，發佈到註冊中心時，_meta 屬性下的擴展會被保留。這允許您包含特定於發佈過程的自定義元數據。

可以刪除/取消發佈我的服務器嗎？

在最後更新時，這在 #104 中正在討論。

可以發佈私有服務器嗎？

私有服務器是那些只能被一小部分用戶訪問的服務器。例如，在私有網絡上發佈的服務器（如 mcp.acme-corp.internal）或在私有包註冊中心上發佈的服務器（例如 npx -y @acme/mcp --registry https://artifactory.acme-corp.internal/npm）。

官方 MCP 註冊中心通常不支持這些，它是為公開可訪問的 MCP 服務器設計的。

如果您想發佈私有服務器，我們建議您託管自己的 MCP 子註冊中心，並將它們添加到那裡。