MCP 注册表目前处于预览阶段。在正式发布之前可能发生破坏性变更或数据重置。如果你遇到任何问题,请在 GitHub 上报告。
软件包类型
MCP 注册表支持多种不同的软件包类型,且每种软件包类型都有其自己的验证方法。npm 软件包
对于 npm 软件包,MCP 注册表目前仅支持 npm 公共注册表(https://registry.npmjs.org)。
npm 软件包在 server.json 中使用 "registryType": "npm"。例如:
server.json
所有权验证
MCP 注册表通过检查package.json 中的 mcpName 来验证 npm 软件包的所有权。mcpName 属性**必须(MUST)**与 server.json 中的服务器名称匹配。例如:
package.json
PyPI 软件包
对于 PyPI 软件包,MCP 注册表目前仅支持官方 PyPI 注册表(https://pypi.org)。
PyPI 软件包在 server.json 中使用 "registryType": "pypi"。例如:
server.json
所有权验证
MCP 注册表通过检查软件包 README(它会成为 PyPI 上的软件包描述)中是否存在mcp-name: $SERVER_NAME 字符串来验证 PyPI 软件包的所有权。该字符串可以隐藏在注释中,但其 $SERVER_NAME 部分**必须(MUST)**与 server.json 中的服务器名称匹配。例如:
README.md
NuGet 软件包
对于 NuGet 软件包,MCP 注册表目前仅支持官方 NuGet 注册表(https://api.nuget.org/v3/index.json)。
NuGet 软件包在 server.json 中使用 "registryType": "nuget"。例如:
server.json
所有权验证
MCP 注册表通过检查软件包 README 中是否存在mcp-name: $SERVER_NAME 字符串来验证 NuGet 软件包的所有权。该字符串可以隐藏在注释中,但其 $SERVER_NAME 部分**必须(MUST)**与 server.json 中的服务器名称匹配。例如:
README.md
Cargo(Rust)软件包
对于 Cargo 软件包,MCP 注册表目前仅支持官方 crates.io 注册表(https://crates.io)。
Cargo 软件包在 server.json 中使用 "registryType": "cargo"。例如:
server.json
运行时模型
Cargo 的运行时模型不同于 npm/PyPI/NuGet。cargo install <crate> 会将编译后的二进制文件放到 PATH 中的 ~/.cargo/bin,之后 MCP 客户端直接按名称调用它。不存在与 npx(npm)、uvx(PyPI)或 dnx(NuGet,.NET 10 SDK Preview 6+)等价的、逐次调用的运行器——安装是一次性的,执行则通过二进制文件名进行。上面的 Cargo 示例出于这个原因刻意省略了 runtimeHint。
Rust MCP 作者有两条一流的分发路径:
- Cargo(
registryType: cargo)——通过 crates.io 以源码形式分发。终端用户需要 Rust 工具链(rustup)来运行cargo install。这是 Rust 生态的惯用做法,与 Rust CLI 通常的发布方式一致。 - MCPB(
registryType: mcpb)——通过 GitHub 或 GitLab Releases 以预构建二进制形式分发。终端用户无需工具链。如果首要目标是”无需 Rust 工具链”,这是正确的选择。
所有权验证
MCP 注册表通过检查软件包 README(它会被渲染为 HTML 并由 crates.io 的静态 CDN 提供)中是否存在mcp-name: $SERVER_NAME 字符串来验证 Cargo 软件包的所有权。其 $SERVER_NAME 部分**必须(MUST)**与 server.json 中的服务器名称匹配。例如:
README.md
<!-- mcp-name: ... --> 隐藏注释形式对 cargo 不起作用——该 token 不会出现在验证器所检查的渲染后 HTML 中。Cargo 作者必须将 mcp-name: token 作为可见的 markdown 文本包含进去。在 Links 区块中放一个简单的列表项是推荐的模式。
Docker/OCI 镜像
对于 Docker/OCI 镜像,MCP 注册表目前支持:- Docker Hub(
docker.io) - GitHub Container Registry(
ghcr.io) - Google Artifact Registry(任意
*.pkg.dev域名) - Azure Container Registry(
*.azurecr.io) - Microsoft Container Registry(
mcr.microsoft.com)
server.json 中使用 "registryType": "oci"。例如:
server.json
identifier 的格式为 registry/namespace/repository:tag。例如 docker.io/user/app:1.0.0 或 ghcr.io/user/app:1.0.0。tag 也可以指定为摘要(digest)。
所有权验证
MCP 注册表通过检查io.modelcontextprotocol.server.name 标注(annotation)来验证 Docker/OCI 镜像的所有权。io.modelcontextprotocol.server.name 标注的值**必须(MUST)**与 server.json 中的服务器名称匹配。例如:
Dockerfile
MCPB 软件包
对于 MCPB 软件包,MCP 注册表目前支持通过 GitHub 或 GitLab releases 托管的 MCPB 制品。 MCPB 软件包在server.json 中使用 "registryType": "mcpb"。例如:
server.json
验证
MCPB 软件包 URL(server.json 中的 identifier)**必须(MUST)**包含字符串 “mcp”。它可以作为 .mcpb 文件扩展名的一部分,或存在于仓库名称中。
server.json 中的软件包元数据**必须(MUST)**包含一个 fileSha256 属性,其值为 MCPB 制品的 SHA-256 哈希,可使用 openssl 命令计算: