Pcb MCP

🚀 MCP 注册表

MCP 注册表为 MCP 客户端提供 MCP 服务器列表，就像 MCP 服务器的应用商店。

| ⚡️ 实时 API 文档 | | 📖 完整文档

🚀 快速开始

开发状态

2025 年 10 月 24 日更新：注册表 API 已进入 API 冻结阶段（v0.1） 🎉。在接下来的一个月或更长时间内，API 将保持稳定，不会有重大变更，这让集成商可以放心地实现支持。此冻结适用于 v0.1 版本，同时 v0 的开发仍在继续。我们将利用这段时间在实际集成中验证 API，并收集反馈，以塑造面向大众的 v1 版本。感谢大家的贡献和耐心等待 —— 你们的参与是我们取得这一进展的关键！

2025 年 9 月 8 日更新：注册表已进入预览阶段 🎉（公告博客文章）。虽然系统现在更加稳定，但这仍然是一个预览版本，可能会出现重大变更或数据重置。后续将发布正式版本（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。您可以这样使用它：

# 构建最新的 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/              # 版本 0 的 API 类型
│   └── model/               # server.json 的数据模型
├── scripts/                 # 开发和测试脚本
├── tests/                   # 集成测试
└── tools/                   # CLI 工具和实用程序
    └── validate-*.sh        # 模式验证工具

身份验证

发布支持多种身份验证方法：

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

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

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

👥 社区项目

查看 社区项目，探索社区创建的与注册表相关的重要项目。

📚 详细文档

如果您的问题在此处未得到解答，请查看 文档 获取更多详细信息！