发布到官方 MCP Registry 时如何进行身份验证
认证方式取决于你要长期维护的命名空间
先确定 server.json 中的服务器名,再选登录命令。个人 GitHub 名称、组织名称和反向域名名称分别依赖不同的身份或控制权。登录成功只代表这次身份验证通过,不代表能够发布任意前缀。以下是基于正文版本的运维选择建议,不是本站执行认证的记录。
| 使用场景 | 先确认的条件 | 适合保存的交接信息 |
|---|---|---|
| 个人项目 | 名称中的 GitHub 用户与认证身份一致 | 精确名称与维护人 |
| 组织项目 | 有维护人能完成组织所需的证明 | 组织、负责人和认证方式 |
| 自有域名项目 | 能维护 DNS 或规定的 HTTP 文件 | 域名、证明位置和密钥负责人 |
| 自动发布 | 工作流有对应的非交互认证入口 | 工作流 revision 与认证方式 |
DNS 和 HTTP 的差异首先是证明放在哪里。能修改解析记录但不控制网站内容的团队,可优先评估 DNS;能够稳定提供规定的 well-known 文件的团队,可评估 HTTP。HTTP 路径若被应用兜底成首页,即使浏览器返回 200,也未必交付了要求的证明文件。DNS 记录未传播时,也应先检查公开记录,而不是立即重新生成密钥。
故障定位按顺序进行:核对服务器名称前缀、认证身份、公开证明内容,最后再查签名和凭据有效性。若登录成功但发布失败,还需查包类型中的所有权验证,避免把包元数据错误误判成登录错误。
交接时应记录证明由谁维护、密钥由谁保管、工作流采用哪种认证;不要保存私钥或完整认证输出。转为 CI 时使用 GitHub Actions列出的相应入口,避免让无人值守任务等待浏览器设备授权。
本文中的身份验证命令按 mcp-publisher v1.8.4(revision 65ee4b2f8456eb753c6e38fa157cc5e6c3d95146)核对。
发布到官方 MCP Registry 之前,你必须先进行身份验证。MCP Registry 支持多种身份验证方法。你选择的身份验证方法决定了服务器名称所使用的命名空间。
如果选择基于 GitHub 的身份验证,server.json 中的服务器名称**必须(MUST)**采用 io.github.username/*(或 io.github.orgname/*)格式。例如 io.github.alice/weather-server。
如果选择基于域名的身份验证,server.json 中的服务器名称**必须(MUST)**采用 com.example.*/* 格式,其中 com.example 是域名的反向 DNS 形式。例如 io.modelcontextprotocol/everything。
| 身份验证方式 | 名称格式 | 示例名称 |
|---|---|---|
| 基于 GitHub | io.github.username/* 或 io.github.orgname/* | io.github.alice/weather-server |
| 基于域名 | com.example.*/* | io.modelcontextprotocol/everything |
GitHub 身份验证
GitHub 身份验证使用由 mcp-publisher CLI 工具发起的 OAuth 流程。
要执行 GitHub 身份验证,请进入服务器项目目录并运行:
mcp-publisher login github你应会看到类似以下内容的输出:
Logging in with github...
To authenticate, please:
1. Go to: https://github.com/login/device
2. Enter code: ABCD-1234
3. Authorize this application
Waiting for authorization...访问该链接,按照提示操作,并输入终端中显示的授权码(例如上面输出中的 ABCD-1234)。完成后返回终端,你应会看到类似以下内容的输出:
Successfully authenticated!
✓ Successfully logged inDNS 身份验证
DNS 身份验证是一种基于域名的身份验证方法,依赖 DNS TXT 记录。
要使用 mcp-publisher CLI 工具执行 DNS 身份验证,请在服务器项目目录中运行以下命令,基于公钥/私钥对生成 TXT 记录:
MY_DOMAIN="example.com"
# Generate public/private key pair using Ed25519
openssl genpkey -algorithm Ed25519 -out key.pem
# Generate TXT record
PUBLIC_KEY="$(openssl pkey -in key.pem -pubout -outform DER | tail -c 32 | base64)"
echo "${MY_DOMAIN}. IN TXT \"v=MCPv1; k=ed25519; p=${PUBLIC_KEY}\""MY_DOMAIN="example.com"
# Generate public/private key pair using ECDSA P-384
openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:secp384r1 -out key.pem
# Generate TXT record
PUBLIC_KEY="$(openssl ec -in key.pem -text -noout -conv_form compressed | grep -A4 "pub:" | tail -n +2 | tr -d ' :\n' | xxd -r -p | base64)"
echo "${MY_DOMAIN}. IN TXT \"v=MCPv1; k=ecdsap384; p=${PUBLIC_KEY}\""MY_DOMAIN="example.com"
MY_PROJECT="myproject"
MY_KEYRING="mykeyring"
MY_KEY_NAME="mykey"
# Log in using gcloud CLI (https://cloud.google.com/sdk/docs/install)
gcloud auth login
# Set default project
gcloud config set project "${MY_PROJECT}"
# Create a keyring in your project
gcloud kms keyrings create "${MY_KEYRING}" --location global
# Create an Ed25519 signing key
gcloud kms keys create "${MY_KEY_NAME}" --default-algorithm=ec-sign-ed25519 --purpose=asymmetric-signing --keyring="${MY_KEYRING}" --location=global
# Enable Application Default Credentials (ADC) so the publisher tool can sign
gcloud auth application-default login
# Attempt login to show the public key
mcp-publisher login dns google-kms --domain="${MY_DOMAIN}" --resource="projects/${MY_PROJECT}/locations/global/keyRings/${MY_KEYRING}/cryptoKeys/${MY_KEY_NAME}/cryptoKeyVersions/1"
# Copy the "Expected proof record":
# ${MY_DOMAIN}. IN TXT "v=MCPv1; k=ed25519; p=${PUBLIC_KEY}"MY_DOMAIN="example.com"
MY_SUBSCRIPTION="subscription name or ID"
MY_RESOURCE_GROUP="MyResourceGroup"
MY_KEY_VAULT="MyKeyVault"
MY_KEY_NAME="MyKey"
# Log in using Azure CLI (https://learn.microsoft.com/en-us/cli/azure/install-azure-cli)
az login
# Set default subscription
az account set --subscription "${MY_SUBSCRIPTION}"
# Create a resource group
az group create --location westus --resource-group "${MY_RESOURCE_GROUP}"
# Create a key vault
az keyvault create --name "${MY_KEY_VAULT}" --location westus --resource-group "${MY_RESOURCE_GROUP}"
# Create an ECDSA P-384 signing key
az keyvault key create --name "${MY_KEY_NAME}" --vault-name "${MY_KEY_VAULT}" --curve P-384
# Attempt login to show the public key
mcp-publisher login dns azure-key-vault --domain="${MY_DOMAIN}" --vault "${MY_KEY_VAULT}" --key "${MY_KEY_NAME}"
# Copy the "Expected proof record":
# ${MY_DOMAIN}. IN TXT "v=MCPv1; k=ecdsap384; p=${PUBLIC_KEY}"然后通过 DNS 提供商的控制面板添加 TXT 记录。TXT 记录可能需要几分钟才能传播。记录传播后,使用 mcp-publisher login 命令登录:
MY_DOMAIN="example.com"
PRIVATE_KEY="$(openssl pkey -in key.pem -noout -text | grep -A3 "priv:" | tail -n +2 | tr -d ' :\n')"
mcp-publisher login dns --domain "${MY_DOMAIN}" --private-key "${PRIVATE_KEY}"MY_DOMAIN="example.com"
PRIVATE_KEY="$(openssl ec -in key.pem -noout -text | grep -A4 "priv:" | tail -n +2 | tr -d ' :\n')"
mcp-publisher login dns --domain "${MY_DOMAIN}" --private-key "${PRIVATE_KEY}"MY_DOMAIN="example.com"
MY_PROJECT="myproject"
MY_KEYRING="mykeyring"
MY_KEY_NAME="mykey"
mcp-publisher login dns google-kms --domain="${MY_DOMAIN}" --resource="projects/${MY_PROJECT}/locations/global/keyRings/${MY_KEYRING}/cryptoKeys/${MY_KEY_NAME}/cryptoKeyVersions/1"MY_DOMAIN="example.com"
MY_KEY_VAULT="MyKeyVault"
MY_KEY_NAME="MyKey"
mcp-publisher login dns azure-key-vault --domain="${MY_DOMAIN}" --vault "${MY_KEY_VAULT}" --key "${MY_KEY_NAME}"HTTP 身份验证
HTTP 身份验证是一种基于域名的身份验证方法,依赖托管在你的域名上的 /.well-known/mcp-registry-auth 文件。例如 https://example.com/.well-known/mcp-registry-auth。
要使用 mcp-publisher CLI 工具执行 HTTP 身份验证,请在服务器项目目录中运行以下命令,基于公钥/私钥对生成 mcp-registry-auth 文件:
# Generate public/private key pair using Ed25519
openssl genpkey -algorithm Ed25519 -out key.pem
# Generate mcp-registry-auth file
PUBLIC_KEY="$(openssl pkey -in key.pem -pubout -outform DER | tail -c 32 | base64)"
echo "v=MCPv1; k=ed25519; p=${PUBLIC_KEY}" > mcp-registry-auth# Generate public/private key pair using ECDSA P-384
openssl genpkey -algorithm EC -pkeyopt ec_paramgen_curve:secp384r1 -out key.pem
# Generate mcp-registry-auth file
PUBLIC_KEY="$(openssl ec -in key.pem -text -noout -conv_form compressed | grep -A4 "pub:" | tail -n +2 | tr -d ' :\n' | xxd -r -p | base64)"
echo "v=MCPv1; k=ecdsap384; p=${PUBLIC_KEY}" > mcp-registry-authMY_DOMAIN="example.com"
MY_PROJECT="myproject"
MY_KEYRING="mykeyring"
MY_KEY_NAME="mykey"
# Log in using gcloud CLI (https://cloud.google.com/sdk/docs/install)
gcloud auth login
# Set default project
gcloud config set project "${MY_PROJECT}"
# Create a keyring in your project
gcloud kms keyrings create "${MY_KEYRING}" --location global
# Create an Ed25519 signing key
gcloud kms keys create "${MY_KEY_NAME}" --default-algorithm=ec-sign-ed25519 --purpose=asymmetric-signing --keyring="${MY_KEYRING}" --location=global
# Enable Application Default Credentials (ADC) so the publisher tool can sign
gcloud auth application-default login
# Attempt login to show the public key
mcp-publisher login http google-kms --domain="${MY_DOMAIN}" --resource="projects/${MY_PROJECT}/locations/global/keyRings/${MY_KEYRING}/cryptoKeys/${MY_KEY_NAME}/cryptoKeyVersions/1"
# Copy the "Expected proof record" to `./mcp-registry-auth`:
# v=MCPv1; k=ed25519; p=${PUBLIC_KEY}MY_DOMAIN="example.com"
MY_SUBSCRIPTION="subscription name or ID"
MY_RESOURCE_GROUP="MyResourceGroup"
MY_KEY_VAULT="MyKeyVault"
MY_KEY_NAME="MyKey"
# Log in using Azure CLI (https://learn.microsoft.com/en-us/cli/azure/install-azure-cli)
az login
# Set default subscription
az account set --subscription "${MY_SUBSCRIPTION}"
# Create a resource group
az group create --location westus --resource-group "${MY_RESOURCE_GROUP}"
# Create a key vault
az keyvault create --name "${MY_KEY_VAULT}" --location westus --resource-group "${MY_RESOURCE_GROUP}"
# Create an ECDSA P-384 signing key
az keyvault key create --name "${MY_KEY_NAME}" --vault-name "${MY_KEY_VAULT}" --curve P-384
# Attempt login to show the public key
mcp-publisher login http azure-key-vault --domain="${MY_DOMAIN}" --vault "${MY_KEY_VAULT}" --key "${MY_KEY_NAME}"
# Copy the "Expected proof record" to `./mcp-registry-auth`:
# v=MCPv1; k=ecdsap384; p=${PUBLIC_KEY}然后将 mcp-registry-auth 文件托管在你的域名的 /.well-known/mcp-registry-auth 路径。文件托管就绪后,使用 mcp-publisher login 命令登录:
MY_DOMAIN="example.com"
PRIVATE_KEY="$(openssl pkey -in key.pem -noout -text | grep -A3 "priv:" | tail -n +2 | tr -d ' :\n')"
mcp-publisher login http --domain "${MY_DOMAIN}" --private-key "${PRIVATE_KEY}"MY_DOMAIN="example.com"
PRIVATE_KEY="$(openssl ec -in key.pem -noout -text | grep -A4 "priv:" | tail -n +2 | tr -d ' :\n')"
mcp-publisher login http --domain "${MY_DOMAIN}" --private-key "${PRIVATE_KEY}"MY_DOMAIN="example.com"
MY_PROJECT="myproject"
MY_KEYRING="mykeyring"
MY_KEY_NAME="mykey"
mcp-publisher login http google-kms --domain="${MY_DOMAIN}" --resource="projects/${MY_PROJECT}/locations/global/keyRings/${MY_KEYRING}/cryptoKeys/${MY_KEY_NAME}/cryptoKeyVersions/1"MY_DOMAIN="example.com"
MY_KEY_VAULT="MyKeyVault"
MY_KEY_NAME="MyKey"
mcp-publisher login http azure-key-vault --domain="${MY_DOMAIN}" --vault "${MY_KEY_VAULT}" --key "${MY_KEY_NAME}"