MCP子注册表服务

MCP子注册表是一个自托管的统一MCP市场聚合层,支持从多个公共注册表同步服务器,并可添加私有服务器,通过单一市场UI和API提供服务。

  • by mcp-reg
  • Go
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 mcp-reg/mcp-sub-registry

使用说明

MCP Sub-Registry

Your own Unified MCP Marketplace — self-hosted, GitOps-driven, and IDE-ready.


MCP子注册表是一个开源聚合层,允许您从不断增长的MCP服务器中构建自定义的统一MCP市场。它与公共注册表同步,允许您添加自己的私有/自定义服务器,并通过单个Marketplace UI和官方 MCP注册API.

为什么?

MCP生态系统正在快速发展。公共注册表来自 模型内容协议.io, GitHub, 微软,其他服务器各自托管自己的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
  1. 您定义 一 registry.json 在您的私有GitHub仓库中——列出要从哪些公共注册表中提取以及要包含哪些私有服务器
  2. 您的IDE请求 MCP子注册表中的服务器
  3. 该服务获取 来自每个配置的源--公共注册表和私有路径
  4. 聚合和转换 将所有服务器合并到一个标准化的目录中
  5. 退货 将统一服务器列表添加到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/<your org>/<your repo name>
  • 请遵循以下说明https://github.com/mcp-reg/mcp-registry-template(或在您的新仓库README.md中)进一步定制您的新MCP子注册表。

部署您的服务器

  • 存储到您最喜欢的平台:Lambda、GCP Cloud Run、Kubernetes。在您首选的容器中进行单二进制部署。
  • 向您的团队提供您的公共URL: https://<your domain>/<your org>/<your repo name>.

配置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://<your domain>/<your org>/<your repo name>。如果你想要一个特定的分支,而不是 main 您还可以配置: https://<your domain>/<your org>/<your repo name>/<branch name> .
  • 备注:此配置要求您的服务器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