/ 目录 / 演练场 / MCP Registry
● 官方 modelcontextprotocol ⚡ 即开即用

MCP Registry

作者 modelcontextprotocol · modelcontextprotocol/registry

MCP server 的官方目录与查找服务——从一个权威来源发现、发布和验证生产级 MCP。

MCP Registry 是 Anthropic 官方认可的 MCP server 列表,对于协议而言相当于 npm/PyPI。它提供 REST API、Go server 以及发布你自己 MCP 的工具。作为希望按能力、语言或发布者发现 MCP 的 client 的上游真相来源。

为什么要用

核心特性

实时演示

实际使用效果

mcp-registry.replay ▶ 就绪
0/0

安装

选择你的客户端

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "mcp-registry": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/registry-mcp"
      ],
      "_inferred": true
    }
  }
}

打开 Claude Desktop → Settings → Developer → Edit Config。保存后重启应用。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "mcp-registry": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/registry-mcp"
      ],
      "_inferred": true
    }
  }
}

Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "mcp-registry": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/registry-mcp"
      ],
      "_inferred": true
    }
  }
}

点击 Cline 侧栏中的 MCP Servers 图标,然后选 "Edit Configuration"。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "mcp-registry": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/registry-mcp"
      ],
      "_inferred": true
    }
  }
}

格式与 Claude Desktop 相同。重启 Windsurf 生效。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "mcp-registry",
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/registry-mcp"
      ]
    }
  ]
}

Continue 使用服务器对象数组,而非映射。

~/.config/zed/settings.json
{
  "context_servers": {
    "mcp-registry": {
      "command": {
        "path": "npx",
        "args": [
          "-y",
          "@modelcontextprotocol/registry-mcp"
        ]
      }
    }
  }
}

加入 context_servers。Zed 保存后热重载。

claude mcp add mcp-registry -- npx -y @modelcontextprotocol/registry-mcp

一行命令搞定。用 claude mcp list 验证,claude mcp remove 卸载。

使用场景

实战用法: MCP Registry

让 Claude 搜索官方注册表,为任务找到合适的 MCP

👤 知道想做什么但不知道哪个 MCP 能做的任何人 ⏱ ~10 min beginner

何时使用: 你需要 Postgres MCP / Notion MCP 等,想要权威的推荐。

步骤
  1. 搜索
    Use registry MCP. Find the top 3 results for keyword 'postgres' and tell me their stars + last update.✓ 已复制
    → 三个候选,带元数据
  2. 检查清单
    For each, show config + tool list so I can pick.✓ 已复制
    → 渲染后的清单
  3. 安装所选
    Install the top result into Claude Desktop.✓ 已复制
    → 配置块写入 claude_desktop_config.json

结果: 从权威来源选择 MCP,而非随机搜索结果。

注意事项
  • 较新的 MCP 可能尚未注册 — 交叉参考 FreeMCPLab 和 GitHub 直接搜索社区驱动的选择

将你的 MCP 发布到官方注册表,让他人发现

👤 拥有稳定、实用 server 的 MCP 作者 ⏱ ~30 min intermediate

何时使用: 你的 MCP 已有 3+ 用户,想要更好的可发现性。

前置条件
  • 带清单的 GitHub 仓库 — 仓库根目录的 server.json 符合注册表 schema
步骤
  1. 验证清单
    Use registry MCP to validate my server.json against the official schema. Tell me what's missing.✓ 已复制
    → Schema 验证报告
  2. 提交
    Submit via the registry CLI. Auth using my GitHub identity.✓ 已复制
    → 提交成功;返回 URL
  3. 验证可发现性
    Search for my MCP by name; confirm it appears.✓ 已复制
    → 搜索中可见

结果: 你的 MCP 已列入官方注册表。

为公司运行内部 MCP 注册表

👤 拥有内部 MCP 的组织平台团队 ⏱ ~60 min advanced

何时使用: 你有专有 MCP,不想放在公开注册表上。

前置条件
  • Go 运行时或 Docker — go install 或 docker pull
步骤
  1. 运行 server
    Start the registry server on internal.mcp.corp. Configure auth.✓ 已复制
    → Server 运行;schema 端点可读
  2. 镜像或精选
    Mirror selected public entries; add private ones from internal teams.✓ 已复制
    → 混合目录
  3. 将 Claude 指向它
    Configure Claude Desktop to use the internal registry URL for discovery.✓ 已复制
    → 发现现在使用内部来源

结果: 内部 MCP 通过你自己的注册表进行治理和发现。

组合

与其他 MCP 搭配,撬动十倍杠杆

SDK + 注册表——构建后发布

交叉参考注册表与精选 awesome 列表

工具

此 MCP 暴露的能力

工具输入参数何时调用成本
search_servers query, runtime?, limit? 发现阶段 0
get_server id 详情页 0
validate_manifest manifest_json 提交前检查 0
submit_server manifest, github_token 发布你的 MCP 0

成本与限制

运行它的成本

API 配额
公开读取无需认证;提交需要 GitHub 认证
每次调用 Token 数
较小——清单是 JSON
费用
免费
提示
在客户端缓存清单结果;它们不会频繁变动

安全

权限、密钥、影响范围

最小权限: github:read (for submission)
凭据存储: GitHub token 仅用于提交时存在环境变量中
数据出站: registry.modelcontextprotocol.io
切勿授予: github:write to private orgs

故障排查

常见错误与修复

Schema 验证失败

将你的 server.json 与 /schemas 中的权威 schema 对比;缺少字段是常见问题

提交被拒绝

检查 GitHub 身份是否与清单发布者匹配;验证仓库是否公开

提交后 server 不可见

索引可能需要几分钟;5 分钟后刷新搜索

替代方案

MCP Registry 对比其他方案

替代方案何时用它替代权衡
Smithery / PulseMCP你想要精美的商业目录第三方索引;这个是上游
FreeMCPLab (this site)你想要精选指南和实操演示,而非原始目录不同形态——游乐场 vs 索引

更多

资源

📖 阅读 GitHub 上的官方 README

🐙 查看未解决的 issue

🔍 浏览全部 400+ MCP 服务器和 Skills