JSON MCP Registry

JSON MCP注册表

一个简单的模型上下文协议（MCP）服务器注册表。这可以作为贵组织批准的远程和本地托管MCP服务器的中央白名单配置。

路由查询： /v0.1/servers

像VS Code中的GitHub Copilot或JetBrains这样的企业客户端遵守官方的开源MCP注册表规范。他们不只是阅读你粘贴的确切网址。他们将您的URL视为 基本URL 并将自动向其附加官方端点路径： /v0.1/servers.

所以，如果你把 https://my-company.com/registry 在GitHub设置中，IDE实际上会向以下对象发出网络请求： https://my-company.com/registry/v0.1/servers

要使一个简单的JSON文件工作，您只需要在静态主机上模拟API文件夹结构。实际的JSON数据存储在 v0.1/servers （没有 .json 扩展）。

托管说明

1.“原始GitHub”方法（最简单）

您可以直接在私有或公共GitHub存储库中托管此内容，甚至无需设置GitHub Pages：

1. 将此存储库推送到GitHub。
2. 文件夹结构 v0.1/servers 已设置。
3. 获取仓库根目录的原始URL。它看起来像： https://raw.githubusercontent.com///main
4. 使用此URL作为您的基本URL。

2.GitHub Pages/S3方法

如果您更喜欢传统的静态托管（GitHub Pages、AWS S3、Cloudflare Pages）：

1. 部署此工作区。文件夹 v0.1 和文件 servers 已经正确定位。
2. 确保您的静态主机使用 application/json 内容类型。
3. 您的基本URL将是您的域（例如。， https://.pages.dev).

将其插入GitHub

一旦您的文件在该路径上生效，您只需将其连接到组织的设置中：

1. 转到您的GitHub企业或组织设置。
2. 导航至 政策->副驾驶->政策 （或AI控制选项卡）。
3. 查找 主控程序 部分并启用它。
4. 粘贴您的 基本URL 进入 MCP注册表URL 现场。
5. 将执行模式设置为“仅注册表”。

验证

此存储库包括验证步骤，以确保您的 v0.1/servers 文件始终格式正确且最新。 GitHub行动(.github/workflows/validate.yml)将自动在Pull Requests和Pushs上运行 main 支。

验证包括：

1. 模式验证：确保注册表符合官方MCP规范。
2. 秘密侦查：扫描潜在泄露的敏感信息（API密钥、URI等）。
3. 版本同步：验证所有基于NPM的服务器是否使用其最新可用版本。

要在本地进行测试：

npm install

# Run all tests (schema + secret detection + version check)
npm test

# Run only version synchronization check
npm run test:versions

自动更新

为了使您的注册表与社区的最新版本保持同步，您可以自动将所有基于NPM的服务器更新到其最新版本：

# Checks NPM registry and updates version strings in v0.1/servers
npm run update:packages

……的结构 v0.1/servers

{
  "servers": [
    {
      "server": {
        "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
        "name": "io.github.namespace/server-name",
        "description": "Clear human-readable explanation...",
        "version": "1.0.0",
        "packages": [
          {
            "registryType": "npm",
            "identifier": "package-name",
            "transport": { "type": "stdio" }
          }
        ]
      },
    }
  ],
  "metadata": {
    "nextCursor": null,
    "count": 1
  }
}

未来路线图（TODO）

1.来源/构建管道

目前，所有MCP服务器都存储在单个 v0.1/servers 文件。随着此注册表的扩展，管理单个JSON文件将导致合并冲突和格式问题。

规划架构：

• 创建一个 src/servers/ 字典，其中每个服务器配置都是一个独立的JSON文件（例如。 src/servers/figma.json).
• 编写Node.js构建脚本(npm run build)即：

- 将所有单独的JSON文件聚合到 v0.1/servers 结构。 - 自动计算并注入 metadata.count 现场。 - 格式化最终输出。

• 这将把注册表的“源代码”与提供给客户端的最终“静态工件”分开。