把 MCP Server 发布到官方 Registry：server.json、所有权校验与 CI 自动化

# macOS / Linux（Homebrew）
brew install mcp-publisher

# Windows（PowerShell，下载预编译二进制）
$arch = "amd64"   # ARM 机器改为 arm64
Invoke-WebRequest -Uri "https://github.com/modelcontextprotocol/registry/releases/download/v1.0.0/mcp-publisher_1.0.0_windows_$arch.tar.gz" -OutFile mcp-publisher.tar.gz
tar xf mcp-publisher.tar.gz

# 验证
mcp-publisher --help

在 Server 项目根目录执行 mcp-publisher init，会自动探测项目生成模板。以一个发布到 npm 的 stdio Server 为例，填完关键字段长这样：

{
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-07-09/server.schema.json",
  "name": "io.github.你的用户名/your-mcp-server",
  "description": "一句话说清这个 Server 提供什么工具、给谁用",
  "version": "1.0.0",
  "packages": [
    {
      "registryType": "npm",
      "identifier": "your-mcp-server",
      "version": "1.0.0",
      "transport": { "type": "stdio" }
    }
  ],
  "repository": {
    "url": "https://github.com/你的用户名/your-mcp-server",
    "source": "github"
  }
}

几个必须核对的点：version 与你 npm 包的版本保持一致；远程 Server 则把 packages 换成 remotes 数组、填你的公开 URL；name 大小写敏感，发布后就是它在目录里的身份证号。

Registry 会去 npm 拉你的包，校验包里声明的 mcpName 与 server.json 的 name 一致——这是防止有人冒充你的 Server 的关键机制。给 package.json 加一个字段：

{
  "name": "your-mcp-server",
  "version": "1.0.0",
  "mcpName": "io.github.你的用户名/your-mcp-server"
}

# 然后发布或更新包
npm publish --access public

校验逻辑：Registry 请求 registry.npmjs.org/your-mcp-server，读取 mcpName，与清单比对——字段缺失或不匹配，发布直接失败。PyPI 包同理，在包的 README 里加一条 HTML 注释形式的 mcp-name 声明；NuGet 也是走 README 注释。

# 路线 A：GitHub OAuth（对应 io.github.用户名/* 命名空间）
mcp-publisher login github
# 会打开浏览器完成 GitHub 授权，回来即拿到你的命名空间

# 路线 B：自有域名（对应 com.你的域名/* 命名空间）
# 生成 Ed25519 密钥对，公钥按官方要求放进 DNS TXT 记录或 .well-known 文件
openssl genpkey -algorithm Ed25519 -out key.pem
mcp-publisher login dns --domain=你的域名.com --private-key=HEX格式的私钥

# 干跑：只校验不提交
mcp-publisher publish --dry-run

# 正式发布
mcp-publisher publish

# 验证：打开官方目录搜索你的 Server
# https://registry.modelcontextprotocol.io/servers/io.github.你的用户名/your-mcp-server

发布成功后，你的 Server 会出现在 registry.modelcontextprotocol.io，并作为上游数据源被 GitHub MCP Registry、VS Code 等下游注册表逐步同步——这也是「发一次、多处可见」的价值所在。

手工发布撑不了几个版本就会忘。把发布挂进 CI：打 v* 标签时自动发 npm、同步版本号、再发布到 Registry。

# .github/workflows/publish.yml 关键步骤（简化示意）
on:
  push:
    tags: ["v*"]
jobs:
  publish:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - name: 版本号写入 server.json（取自 tag）
        run: |
          VERSION="${GITHUB_REF_NAME#v}"
          jq --arg v "$VERSION" '.version = $v |
             (.packages[] | select(.registryType=="npm") | .version) = $v' \
             server.json > tmp.json && mv tmp.json server.json
      - name: npm 发布
        run: npm publish --access public
        env:
          NODE_AUTH_TOKEN: ${{ secrets.NPM_TOKEN }}
      - name: MCP Registry 发布
        run: |
          mcp-publisher login github   # CI 内用 token 方式认证
          mcp-publisher publish
        env:
          MCP_PRIVATE_KEY: ${{ secrets.MCP_PRIVATE_KEY }}

需要配置两个 secret：NPM_TOKEN（npm 发布令牌）与 Registry 认证凭据。此后你的发布流程收敛成一条命令：npm version patch && git push --tags。