modelcontextprotocol/registry

A community driven registry service for Model Context Protocol (MCP) servers.

什么是 MCP Registry?

MCP Registry 是一个公共服务,让 Model Context Protocol (MCP) 客户端能够发现与 MCP 兼容的服务器——本质上就是 AI 模型托管端点的“应用商店”。它公开了一个稳定的 HTTP API(目前为 v0.1),该 API 会返回一份经过整理的服务器描述档清单(server.json 文件),让开发者可以通过程序方式寻找、连接并与模型托管服务进行交互。

为什么它很重要

  • 标准化发现 – 工具无需硬编码端点 URL,而是可以查询注册表以获取最新的服务器元数据(功能、验证方法、版本控制等)。
  • 安全与验证 – 注册表会验证每个项目(GitHub OAuth、DNS/HTTP 所有权证明),以减少恶意或配置错误的列表。
  • 生态系统协调 – 通过提供单一事实来源,注册表帮助不同的 MCP 项目进行互操作,而无需各自维护目录。

核心功能(如 README 所述)

功能 描述
API 冻结 (v0.1) 公共 API 已锁定一个月,让整合者能针对稳定的合约进行开发。
基于 Docker 的开发 make dev-compose 可在本地启动注册表以及 PostgreSQL 实例。
种子数据 服务启动时会镜像生产环境注册表的过滤子集,确保开发环境的真实性。
发布 CLI 独立的 mcp-publisher 工具(由 cmd/publisher 构建)负责处理服务器注册;它通过 GitHub OAuth、OIDC、DNS 或 HTTP 挑战进行验证。
验证 支持 GitHub OAuth、GitHub OIDC (用于 CI)、DNS 验证以及 HTTP 验证,以证明命名空间所有权。
可观测性 内置用于指标与监控的遥测功能(参见 internal/telemetry)。
基础设施即代码 部署清单位于 deploy/ (Pulumi)。
版本化 API 类型 公共 API 结构位于 pkg/api/v0 下,使未来的版本控制变得简单直接。

幕后推手是谁?

该项目由一个 Registry Working Group 负责管理,成员包含来自多家公司(Stacklok、PulseMCP、TeamSpark、Ravenmail)的工程师。欢迎通过 Discord、GitHub Discussions 和公共博客提供社区意见。

如何开始

  1. 本地执行 – 安装 Docker、Go 和 ko;然后执行 make dev-compose。服务将可在 http://localhost:8080 访问。
  2. 探索 API – 即时 OpenAPI 文档托管于 https://registry.modelcontextprotocol.io/docs。
  3. 发布您自己的服务器 – 使用 make publisher 构建 CLI,并遵循 docs/modelcontextprotocol-io/quickstart.mdx 中的快速入门指南。
  4. 贡献 – Fork、进行修改并提交 PR;Linting 和测试通过 make check 执行。

何时使用

如果您正在构建一个需要发现或列出 MCP 兼容模型托管服务的应用程序(例如客户端库、UI 仪表板或 AI 代理编排平台),请将其指向 MCP Registry,而不是维护静态清单。注册表的验证和身份验证机制也使其成为生产部署的可靠来源。


以上所有信息均直接取自仓库的 README;未添加任何外部假设。

相关

  • 项目
  • 项目
  • 项目
  • 项目
  • 项目