MCP 注册中心

MCP 注册中心为 MCP 客户端提供 MCP 服务器列表，类似于 MCP 服务器的应用商店。

📤 发布我的 MCP 服务器 | ⚡️ 实时 API 文档 | 👀 生态系统愿景 | 📖 完整文档

开发状态

2025-10-24 更新: 注册中心 API 已进入 API 冻结（v0.1） 🎉。在未来一个月或更长时间内，API 将保持稳定，不会引入破坏性变更，以便集成方能够放心地实现支持。此次冻结仅针对 v0.1 版本，而 v0 版本的开发仍在继续。我们将利用这段时间在实际集成中验证 API，并收集反馈以制定面向正式发布的 v1 版本。感谢各位的贡献与耐心——正是你们的参与才让我们走到今天！

2025-09-08 更新: 注册中心已上线预览版 🎉 (公告博客文章)。尽管系统目前更加稳定，但这仍然是预览版本，仍可能出现破坏性变更或数据重置。正式发布（GA）将在稍后推出。我们非常欢迎您的反馈，请前往 GitHub 讨论区 或 #registry-dev Discord 提出（加入详情请见此处)。

当前主要维护者：

• Adam Jones（Anthropic）@domdomegg
• Tadas Antanavicius（PulseMCP）@tadasant
• Toby Padilla（GitHub）@toby
• Radoslav (Rado) Dimitrov（Stacklok）@rdimitrov

贡献方式

我们使用多种渠道进行协作——详情请参阅 modelcontextprotocol.io/community/communication。

通常情况下（但不总是），想法会通过以下流程推进：

• Discord - 实时社区讨论
• 讨论区 - 提出并讨论产品或技术需求
• 问题 - 跟踪明确的技术任务
• 拉取请求 - 针对问题贡献代码

快速入门：

前置条件

• Docker
• Go 1.24.x
• ko - Go 的容器镜像构建工具（安装说明）
• golangci-lint v2.4.0

运行服务端

# 启动完整的开发环境
make dev-compose

这将启动运行在 localhost:8080 的注册中心服务，并配备 PostgreSQL 数据库。数据库使用临时存储，每次重启容器时都会被重置，从而确保开发和测试时处于干净的状态。

注意: 注册中心使用 ko 构建容器镜像。make dev-compose 命令会自动使用 ko 构建注册中心镜像，并将其加载到本地 Docker 守护进程中，然后再启动各项服务。

默认情况下，注册中心会从生产 API 中抽取经过筛选的服务器子集作为种子数据（以加快启动速度），从而确保本地环境与生产环境的行为一致，并且所有种子数据都通过验证。若需离线开发，您也可以通过文件导入种子数据而不进行验证，只需设置 MCP_REGISTRY_SEED_FROM=data/seed.json MCP_REGISTRY_ENABLE_REGISTRY_VALIDATION=false make dev-compose 即可。

该配置可通过 docker-compose.yml 中的环境变量进行调整——参考 .env.example 获取示例。

# 运行最新稳定版
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:latest

# 运行主分支的最新版本（持续部署）
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main

# 运行特定版本
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:v1.0.0

# 运行主分支的开发构建
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:main-20250906-abc123d

发布服务器

为了发布服务器，我们开发了一个简单的命令行工具。您可以按如下方式使用：

# 构建最新的 CLI 工具
make publisher

# 使用它！
./bin/mcp-publisher --help

更多详细信息请参阅 发布者指南。

其他命令

# 运行代码检查、单元测试和集成测试
make check

此外还有一些对开发有用的命令。运行 make help 可了解更多内容，或查看 Makefile。

架构

项目结构

├── cmd/                     # 应用程序入口点
│   └── publisher/           # 服务器发布工具
├── data/                    # 种子数据
├── deploy/                  # 部署配置（Pulumi）
├── docs/                    # 文档
├── internal/                # 私有应用代码
│   ├── api/                 # HTTP 处理程序和路由
│   ├── auth/                # 身份验证（GitHub OAuth、JWT、命名空间拦截）
│   ├── config/              # 配置管理
│   ├── database/            # 数据持久化（PostgreSQL）
│   ├── service/             # 业务逻辑
│   ├── telemetry/           # 指标与监控
│   └── validators/          # 输入验证
├── pkg/                     # 公开包
│   ├── api/                 # API 类型和结构
│   │   └── v0/              # v0 版本的 API 类型
│   └── model/               # server.json 的数据模型
├── scripts/                 # 开发和测试脚本
├── tests/                   # 集成测试
└── tools/                   # CLI 工具和实用程序
    └── validate-*.sh        # 模式验证工具

身份验证

Publishing 支持多种身份验证方式：

• GitHub OAuth - 通过登录 GitHub 进行发布
• GitHub OIDC - 从 GitHub Actions 中进行发布
• DNS 验证 - 用于证明对域名及其子域名的所有权
• HTTP 验证 - 用于证明对域名的所有权

注册表在发布时会验证命名空间的所有权。例如，要发布……：

• io.github.domdomegg/my-cool-mcp，您必须以 domdomegg 的身份登录 GitHub，或者在 domdomegg 的仓库中运行 GitHub Actions；
• me.adamjones/my-cool-mcp，您必须通过 DNS 或 HTTP 挑战来证明对 adamjones.me 的所有权。

社区项目

请查看 社区项目，了解社区创建的值得关注的与注册表相关的成果。

更多文档

如果您在此处未找到答案，请参阅 文档 以获取更多详细信息！

MCP Registry 快速上手指南

MCP Registry 是一个专为 MCP 客户端设计的服务器注册中心，类似于"MCP 服务器的应用商店”，用于发布和发现 MCP 服务器。

环境准备

在开始之前，请确保您的开发环境满足以下要求：

• 操作系统：支持 Docker 的 Linux、macOS 或 Windows (WSL2)
• Docker：用于容器化运行环境
• Go：版本需为 1.24.x
• ko：Go 语言的容器镜像构建工具 (安装指南)
• golangci-lint：版本需为 v2.4.0

提示：国内开发者若遇到 Go 模块下载缓慢问题，建议配置 GOPROXY=https://goproxy.cn,direct。

安装与启动

本项目推荐使用 make 命令一键启动完整的本地开发环境（包含 PostgreSQL 数据库）。

1. 克隆项目

git clone https://github.com/modelcontextprotocol/registry.git
cd registry

2. 启动开发环境

执行以下命令将自动构建镜像并启动服务：

make dev-compose

• 访问地址：服务启动后，可在浏览器访问 http://localhost:8080。
• 数据说明：默认情况下，数据库使用临时存储，每次重启容器会重置数据。系统会自动从生产环境同步一部分经过验证的种子数据，以确保本地环境与生产行为一致。
• 离线模式：若需完全离线开发且跳过数据验证，可使用：

  MCP_REGISTRY_SEED_FROM=data/seed.json MCP_REGISTRY_ENABLE_REGISTRY_VALIDATION=false make dev-compose
  

替代方案：直接运行 Docker 镜像

如果您仅需运行服务而不需要开发源码，可直接拉取预构建镜像：

# 运行最新稳定版
docker run -p 8080:8080 ghcr.io/modelcontextprotocol/registry:latest

基本使用

发布 MCP 服务器

Registry 提供了一个简单的 CLI 工具用于发布服务器。

1. 构建发布工具

在项目根目录执行：

make publisher

2. 查看帮助与使用

构建完成后，二进制文件位于 ./bin/mcp-publisher。查看使用说明：

./bin/mcp-publisher --help

3. 认证方式

发布服务器时需要验证命名空间所有权，支持以下认证方式：

• GitHub OAuth：登录 GitHub 账号发布（例如发布 io.github.username/server）。
• GitHub OIDC：在 GitHub Actions 中自动发布。
• DNS/HTTP 验证：通过解析记录或文件托管证明域名所有权（例如发布 com.example/server）。

详细发布流程请参考 官方发布指南。

其他常用命令

• 运行检查（代码风格、单元测试、集成测试）：

  make check
  

• 查看所有可用命令：

  make help