跳到主要内容

MCP注册表（2025-09-08）—— 通用注册表 API 规范

· 阅读需 2 分钟
Timandes White
Timandes White

翻译自：https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/api/generic-registry-api.md

一个标准化的RESTful HTTP API，用于MCP注册表提供一致的端点，以发现和检索MCP服务器。

另请参阅：

浏览完整的API规范​

📋 交互式查看完整的 API 规范：在 OpenAPI 查看器中打开 openapi.yaml，例如 Stoplight Elements。

官方注册表在此基础上还有一些额外的端点和限制。有关详细信息，请参阅官方注册表 API 规范。

快速参考​

核心端点​

  • GET /v0/servers - 列出所有带有分页功能的服务器
  • GET /v0/servers/{id} - 根据UUID获取服务器详细信息
  • POST /v0/publish - 发布新服务器（可选，注册表特定的身份验证）

认证​

  • 读取操作：无需身份验证
  • 写操作：注册表特定的身份验证（如果支持）。

内容类型​

所有请求和响应都使用 application/json

基本示例：列出服务器​

curl https://registry.example.com/v0/servers?limit=10
{
  "servers": [
    {
      "name": "io.modelcontextprotocol/filesystem",
      "description": "Filesystem operations server", 
      "status": "active",
      "version": "1.0.2"
    }
  ],
  "metadata": {
    "count": 10,
    "next_cursor": "eyJ..."
  }
}

要查看完整的端点文档，请在架构查看器中查看 OpenAPI 规范。