MCP Registry

MCP Registry 为 MCP 客户端提供服务器列表，就像 MCP 服务器的应用商店一样。它是公开可用的 MCP 服务器的权威存储库。

快速访问

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 遵循以下核心设计原则：

1. 🎯 单一真实来源：公开可用 MCP 服务器的权威元数据存储库
2. ⚖️ 供应商中立：不偏向特定服务器或组织
3. 🔒 行业安全标准：利用现有包注册中心的安全性
4. 🔧 可重用性：API 形状设计为可重用，支持私有/内部注册中心
5. 📈 渐进增强：从 MVP 开始，为未来功能构建基础

社区和贡献

协作渠道

• Discord - 实时社区讨论
• GitHub Discussions - 产品/技术需求讨论
• GitHub Issues - 技术工作跟踪
• Pull Requests - 代码贡献

核心维护者

• Adam Jones (Anthropic) @domdomegg
• Tadas Antanavicius (PulseMCP) @tadasant
• Toby Padilla (GitHub) @toby

下一步

快速导航

• 新手入门: 发布指南 → CLI 工具
• 开发者: 消费数据 → GitHub Actions
• 问题支持: FAQ → API 文档
• 社区参与: GitHub 讨论 → 技术支持