MCP Sub-Registry
Your own Unified MCP Marketplace — self-hosted, GitOps-driven, and IDE-ready.
______________________________________________________________________
MCP子注册表是一个开源聚合层，允许您从不断增长的MCP服务器中构建自定义的统一MCP市场。它与公共注册表同步，允许您添加自己的私有/自定义服务器，并通过单个Marketplace UI和官方 MCP注册API.
为什么？
MCP生态系统正在快速发展。公共注册表来自 模型内容协议.io, , 微软，其他服务器各自托管自己的MCP服务器目录。但如果你是一个组织，你会面临一个支离破碎的局面：
- 碎片化：服务器分散在多个公共注册表中。
- 专用MCP服务器：您有无法在公共注册表上运行的私有内部MCP服务器。
- 无策划：您希望您的团队看到正确的服务器，而不是全部2000多台服务器。
- 没有单层玻璃：在注册表之间切换以找到所需内容是一种时间消耗
- 控制：你需要控制你的团队可以看到和使用什么——而不是一个免费的。
解决方案
MCP子注册表 是位于公共MCP注册表和开发人员工具之间的自托管聚合层。一个单一的网关，可以从公共注册表的任何组合中提取数据，合并到您的私有/自定义服务器中，并通过一个统一的Marketplace UI和 MCP注册API.
免费试用
不需要私人注册表？或者只想创建一个公共子注册表（Marketplace UI+neneneba API），其中包含您为团队策划的MCP服务器列表。使用我们的免费托管服务 mcp-reg.com 浏览并连接到公共MCP子注册表。
请访问以下网址观看演示： mcp-reg.com/mcp-reg/demo.
关键能力
- 聚合 来自官方MCP注册中心、GitHub、微软和任何其他实现 API MCP官方注册处 归入一个目录
- 添加专用服务器 只有您的组织可以访问——在您自己的GitHub仓库中定义
- 管理和控制 您的团队可以使用哪些服务器
- IDE支持 通过一个符合标准的API端点。支持的IDE包括VS Code和Visual Studio。查看支持的IDE 这里.
- 随时随地部署 作为具有嵌入式web UI的单个二进制文件
- 保持同步 使用GitOps，您的注册表配置位于版本控制中
自助和私人
使用此开源项目 自托管 并连接到您自己的 私有注册表存储库 并通过支持GitOps的私有存储库管理您的子注册表。
______________________________________________________________________
运作原理
sequenceDiagram
participant IDE as VS Code
participant Registry as Your MCP Registry Service
participant GitHub as Your Private GitHub Repo
participant Public as Public MCP Registries
IDE->>Registry: Request MCP servers
Registry->>GitHub: Fetch registry.json
GitHub-->>Registry: Registry configuration
Registry->>GitHub: Fetch private servers
GitHub-->>Registry: Server definitions
Registry->>Public: Fetch public servers (optional)
Public-->>Registry: Server catalog
Registry->>Registry: Aggregate & transform
Registry-->>IDE: Unified server list- 您定义 一
registry.json在您的私有GitHub仓库中——列出要从哪些公共注册表中提取以及要包含哪些私有服务器 - 您的IDE请求 MCP子注册表中的服务器
- 该服务获取 来自每个配置的源--公共注册表和私有路径
- 聚合和转换 将所有服务器合并到一个标准化的目录中
- 退货 将统一服务器列表添加到IDE，即可使用
______________________________________________________________________
快速开始
安装
curl -fsSL https://raw.githubusercontent.com/mcp-reg/mcp-sub-registry/main/scripts/install.sh | bash运行服务器
mcp-registry然后打开http://localhost:8080在您的浏览器中。
使用GitHub代币（用于私有仓库）
GITHUB_TOKEN=your_token mcp-registry设置Git配置报告
- 分叉或克隆模板仓库：https://github.com/mcp-reg/mcp-registry-template .按下 使用此模板 在Github用户界面中。
- 现在，您已经使用基本配置配置了MCP子注册表。
- 通过您的服务器访问您在以下位置创建的仓库的Marketplace UI：
http://localhost:8080// - 请遵循以下说明https://github.com/mcp-reg/mcp-registry-template（或在您的新仓库README.md中）进一步定制您的新MCP子注册表。
部署您的服务器
- 存储到您最喜欢的平台：Lambda、GCP Cloud Run、Kubernetes。在您首选的容器中进行单二进制部署。
- 向您的团队提供您的公共URL：
https:////.
配置VS代码/Visual Studio
- 按照以下说明操作：https://docs.github.com/en/copilot/how-tos/administer-copilot/manage-mcp-usage/configure-mcp-server-access关于如何配置MCP注册表URL，该URL将在整个组织中用于VS Code和/或Visual Studio。使用网址：
https:////。如果你想要一个特定的分支，而不是main您还可以配置： `https://///
`.
- 备注：此配置要求您的服务器url对公众开放。
______________________________________________________________________
服务器配置
| 变量 | 默认值 | 描述 |
|---|---|---|
PORT | 8080 | 服务器端口 |
GITHUB_TOKEN | none | GitHub auth令牌（私人转发需要，建议公共转发避免API费率限制） |
GITHUB_API_BASE | https://api.github.com | GitHub API URL（适用于GitHub企业版） |
CACHE_TTL | 1h | 缓存注册表数据的TTL |
CACHE_ENABLED | true | 启用/禁用缓存 |
BROWSER_CACHE_TTL | 5m | HTTP缓存控制标头TTL |
看 .env.example 对于所有可用的环境变量。
______________________________________________________________________
API 参考
| 端点 | 描述 |
|---|---|
GET /health | 健康检查 |
GET /{org}/{repo}/{branch}/v0.1/servers | 列出所有服务器 |
GET /{org}/{repo}/{branch}/v0.1/servers?search=name | 搜索服务器 |
GET /{org}/{repo}/{branch}/v0.1/servers/{name}/versions/latest | 获取最新版本 |
GET /{org}/{repo}/{branch}/v0.1/servers/{name}/versions/{version} | 获取特定版本 |
POST /{org}/{repo}/{branch}/v0.1/refresh | 缓存无效 |
______________________________________________________________________
发展
看 贡献.md 了解更多详情。
______________________________________________________________________
许可证
MIT许可证-请参阅 许可证 了解详情。
______________________________________________________________________
mcp-reg.com · Issues