跳到主要内容

MCP注册表（2025-09-08）————发布者CLI命令参考

· 阅读需 4 分钟

翻译自：https://github.com/modelcontextprotocol/registry/blob/main/docs/reference/cli/commands.md

mcp-publisher CLI 工具的完整命令参考。

请参阅发布指南，了解使用CLI发布服务器的详细步骤。

安装​

通过 Homebrew 安装（macOS/Linux）：

$ brew install mcp-publisher

全局选项​

所有命令支持：

  • --help, -h - 显示命令帮助
  • --registry - 注册表URL（默认值：https://registry.modelcontextprotocol.io）

命令​

mcp-publisher init​

生成一个带有自动检测功能的server.json模板。

用法：

mcp-publisher init [options]

行为：

  • 在当前目录中创建 server.json
  • 自动检测包管理器（如 package.json、setup.py 等）
  • 在可能的情况下预填充字段
  • 提示输入缺失的必填字段

示例输出：

{
  "name": "io.github.username/server-name",
  "description": "TODO: Add server description",
  "version": "1.0.0",
  "packages": [
    {
      "registry_type": "npm",
      "identifier": "detected-package-name",
      "version": "1.0.0"
    }
  ]
}

mcp-publisher login <method>​

使用注册表进行认证。

认证方法：

GitHub互动​

mcp-publisher login github [--registry=URL]
  • 打开浏览器进行GitHub OAuth流程
  • 授予对 io.github.{username}/* 和 io.github.{org}/* 命名空间的访问权限。

GitHub OIDC（持续集成/持续交付）​

mcp-publisher login github-oidc [--registry=URL]
  • 自动使用 GitHub Actions OIDC 令牌
  • 在工作流中需要具有 id-token: write 权限。
  • 不需要浏览器交互。

另请参阅[从 GitHub Actions 发布的指南]。

DNS 验证​

mcp-publisher login dns --domain=example.com --private-key=HEX_KEY [--registry=URL]
  • 验证域名所有权通过DNS TXT记录
  • 授予对 com.example.* 命名空间的访问权限
  • 需要 Ed25519 私钥（64 个字符的十六进制）。

设置：

# 生成密钥对
openssl genpkey -algorithm Ed25519 -out key.pem

# 获取用于DNS记录的公钥
openssl pkey -in key.pem -pubout -outform DER | tail -c 32 | base64

# 添加DNS TXT记录:
# example.com. IN TXT "v=MCPv1; k=ed25519; p=PUBLIC_KEY"

# 提取用于登录的私钥
openssl pkey -in key.pem -noout -text | grep -A3 "priv:" | tail -n +2 | tr -d ' :\n'

HTTP验证​

mcp-publisher login http --domain=example.com --private-key=HEX_KEY [--registry=URL]
  • 通过HTTPS端点验证域所有权
  • 授予对 com.example.* 命名空间的访问权限
  • 需要 Ed25519 私钥（64 个字符的十六进制）。

设置：

# 生成密钥对（与DNS相同）
openssl genpkey -algorithm Ed25519 -out key.pem

# 托管公钥到以下地址：
# https://example.com/.well-known/mcp-registry-auth
# 内容：v=MCPv1; k=ed25519; p=PUBLIC_KEY

匿名（测试）​

mcp-publisher login none [--registry=URL]
  • 没有身份验证 - 仅供本地测试
  • 仅适用于本地注册表实例

mcp-publisher publish​

将服务器发布到注册表。

有关发布流程的详细指南，请参阅发布指南。

用法：

mcp-publisher publish [options]

选项:

  • --file=PATH - 指向 server.json 的路径 (默认: ./server.json)
  • --registry=URL - 覆盖注册表 URL
  • --dry-run - 验证但不发布

流程：

  1. 根据模式验证 server.json
  2. 验证包所有权（参见[官方注册要求]）
  3. 检查命名空间认证
  4. 发布到注册库

示例：

# 基本发布
mcp-publisher publish

# 干运行验证
mcp-publisher publish --dry-run

# 自定义文件位置  
mcp-publisher publish --file=./config/server.json

mcp-publisher logout​

清除存储的身份验证凭据。

用法：

mcp-publisher 注销

行为：

  • 删除 ~/.mcp_publisher_token
  • 不会在服务器端撤销令牌

配置​

令牌存储​

认证令牌以JSON格式存储在~/.mcp_publisher_token中。

{
  "token": "jwt-token-here",
  "registry_url": "https://registry.modelcontextprotocol.io",
  "expires_at": "2024-12-31T23:59:59Z"
}