发布远程服务器 - MCP 中文文档

MCP Registry 目前处于预览阶段。在正式发布之前可能会发生破坏性变更或数据重置。如果您遇到任何问题，请在 GitHub 上报告。

MCP Registry 通过 server.json 中的 remotes 属性支持远程 MCP 服务器：

server.json

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "com.example/acme-analytics",
  "title": "ACME Analytics",
  "description": "实时商业智能和报告平台",
  "version": "2.0.0",
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://analytics.example.com/mcp"
    }
  ]
}

远程服务器在其指定 URL 上必须是公开可访问的。

传输类型

远程服务器应使用 Streamable HTTP 传输。SSE 传输已弃用，因此仅在需要支持现有客户端时才发布 "sse" 远程端点。远程服务器也可以在不同 URL 上同时支持这两种传输。通过将 remotes 条目的 type 属性设置为 "streamable-http" 或 "sse" 来指定传输：

server.json

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "com.example/acme-analytics",
  "title": "ACME Analytics",
  "description": "实时商业智能和报告平台",
  "version": "2.0.0",
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://analytics.example.com/mcp"
    },
    {
      "type": "sse",
      "url": "https://analytics.example.com/sse"
    }
  ]
}

URL 模板变量

远程服务器可以使用 {curly_braces} 表示法定义 URL 模板变量。这使得多租户部署成为可能，其中单个服务器定义可以支持具有可配置值的多个端点：

server.json

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "com.example/acme-analytics",
  "title": "ACME 分析",
  "description": "实时商业智能和报告平台",
  "version": "2.0.0",
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://{tenant_id}.analytics.example.com/mcp",
      "variables": {
        "tenant_id": {
          "description": "您的租户标识符（例如：'us-cell1'、'emea-cell1'）",
          "isRequired": true
        }
      }
    }
  ]
}

配置此服务器时，用户提供其 tenant_id 值，URL 模板将被解析为适当的端点（例如 https://us-cell1.analytics.example.com/mcp）。变量支持额外的属性，如 default、choices 和 isSecret：

server.json

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "com.example/multi-region-mcp",
  "title": "多区域 MCP",
  "description": "具有区域端点的 MCP 服务器",
  "version": "1.0.0",
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://api.example.com/{region}/mcp",
      "variables": {
        "region": {
          "description": "部署区域",
          "isRequired": true,
          "choices": [
            "us-east-1",
            "eu-west-1",
            "ap-southeast-1"
          ],
          "default": "us-east-1"
        }
      }
    }
  ]
}

HTTP 头

可以通过向 remotes 条目添加 headers 属性来指示 MCP 客户端发送特定的 HTTP 头：

server.json

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "com.example/acme-analytics",
  "title": "ACME 分析",
  "description": "实时商业智能和报告平台",
  "version": "2.0.0",
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://analytics.example.com/mcp",
      "headers": [
        {
          "name": "X-API-Key",
          "description": "用于身份验证的 API 密钥",
          "isRequired": true,
          "isSecret": true
        }
      ]
    }
  ]
}

支持远程和非远程安装

remotes 属性可以与 server.json 中的 packages 属性共存，以允许 MCP 宿主应用程序选择首选的安装方法。

server.json

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "name": "io.github.username/email-integration-mcp",
  "title": "邮件集成",
  "description": "发送电子邮件并管理电子邮件账户",
  "version": "1.0.0",
  "remotes": [
    {
      "type": "streamable-http",
      "url": "https://email.example.com/mcp"
    }
  ],
  "packages": [
    {
      "registryType": "npm",
      "identifier": "@example/email-integration-mcp",
      "version": "1.0.0",
      "transport": {
        "type": "stdio"
      }
    }
  ]
}

​传输类型

​URL 模板变量

​HTTP 头

​支持远程和非远程安装

传输类型

URL 模板变量

HTTP 头

支持远程和非远程安装