MCP 服务器怎么发布到官方 registry?
先发布到官方 MCP Registry(registry.modelcontextprotocol.io),因为官方文档说它主要给下游目录站使用。官方文档(2026-11-09 读)写明:registry 是公开 MCP 服务器的集中元数据库,只存元数据,不存包本身;它目前是 preview,可能有破坏性改动或数据重置;不支持私有服务器。文档还写它主要给下游聚合站使用,所以你在这里登记的名称和描述,会被别的目录站拿去用。
1. 把包发布到公共包仓库
registry 支持 npm、PyPI、NuGet、Cargo、Docker/OCI 和 MCPB。远程服务器改用 remotes 字段,地址必须公开可访问,文档推荐 streamable-http,sse 已弃用。
2. 在包里写验证信息
npm 包在 package.json 里加 mcpName;PyPI 包在 README 里写一行 mcp-name: 你的服务器名。用 GitHub 登录时,名称必须以 io.github.你的用户名/ 开头。
3. 用 mcp-publisher 生成并编辑 server.json
运行 mcp-publisher init 生成模板,改好 name、description、version 和 packages。server.json 的 name 必须与 package.json 的 mcpName 一致。
4. 登录并发布
mcp-publisher login github,再 mcp-publisher publish。发布后用 registry 的 API 查一次,确认条目在、status 是 active。
{
"$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
"name": "io.github.example/notes-search",
"title": "Notes Search",
"description": "Search and read Markdown notes in a local folder. Read-only; Node.js 18+.",
"repository": { "url": "https://github.com/example/notes-search-mcp", "source": "github" },
"version": "1.2.0",
"packages": [
{ "registryType": "npm", "identifier": "@example/notes-search-mcp", "version": "1.2.0", "transport": { "type": "stdio" } }
]
}
官方的审核很宽:只删非法内容、恶意软件、垃圾和不能用的服务器;文档举的垃圾例子里包括“描述里塞满营销话术、实现却无关”和“同一个服务器换名字重复提交”。所以 description 写事实,不写口号。
目录站和 GitHub 对 AI 爬虫是什么态度?
我们查的 5 个站里,没有一家按名字拦 GPTBot、ClaudeBot 或 PerplexityBot。2026-11-09 用 curl 读了它们的 robots.txt,再抽样打开服务器页面看原始 HTML:每个抽样页面的描述文字都直接写在 HTML 正文里,不需要等脚本。
| 站 | robots.txt 里值得注意的(2026-11-09) | 抽样页面的原始 HTML |
|---|---|---|
| registry.modelcontextprotocol.io | /robots.txt 返回 404,没有声明规则。API 不需要登录:/v0/servers 和 /v0.1/servers 都返回 200 和 JSON | 页面是目录入口,数据靠 API 取;我们没有抽样条目页 |
| smithery.ai | 只有 * 一组:Allow /,禁 /api/、/_next/、/admin/ 等;没有点名 AI 爬虫 | /servers/upstash/context7-mcp:描述在正文里,也在 meta description 里;没有 JSON-LD |
| glama.ai | * 一组带 Content-Signal: ai-train=no, search=yes, ai-input=yes;禁 /api/、/mcp/servers/*/tree/、/blob/ 等子页;服务器页本身没被禁 | /mcp/servers/shanejonas/openrpc-mcp-server:README 渲染进了正文,meta description 是仓库的一句描述 |
| mcp.so | 只有 * 一组:禁 /admin、/api/、/search 和带 q= 的查询串;服务器页没被禁 | /servers/sequentialthinking:描述在正文里;有 FAQPage 的 JSON-LD;meta description 是自动生成的句式 |
| github.com | 点名 GPTBot、ClaudeBot、PerplexityBot 等同一组:仓库首页可抓,/tree/、/blob/ 一类子页和 ?tab= 参数页被禁 | modelcontextprotocol/servers:README 首段在正文里,写明列表请去 MCP Registry |
这只是 robots.txt 文字和我们的请求,不是 AI 爬虫真实取到的内容;CDN 或防火墙可能另外拦截。几个爬虫各管什么,见 AI 爬虫的 robots.txt 怎么写?;正文要不要靠脚本渲染,见 AI 爬虫会执行 JavaScript 吗?。
MCP 服务器会出现在 AI 回答里吗?
分两件事:一是被 AI 应用“连接使用”,二是被 AI 回答“推荐引用”。第一件官方说明得很清楚,第二件我们没有证据。
| 问题 | 我们查到的 | 依据 |
|---|---|---|
| 用户怎么把你的服务器接进 Claude | 用户在连接器设置里填你的远程服务器 URL。连接由 Anthropic 云端发起,服务器必须能从公网(Anthropic 的 IP 段)访问;放在内网或 VPN 后面连不上 | Claude 帮助中心「Get started with custom connectors using remote MCP」,2026-11-09 读 |
| 怎么用在 ChatGPT | 远程 MCP 服务器可以通过 ChatGPT 和 Codex 的插件、ChatGPT deep research 和 API 使用;配合 deep research 和公司知识,要实现 search 和 fetch 两个只读工具 | OpenAI 开发者文档「Building MCP servers for plugins and API integrations」,2026-11-09 读 |
| 目录页会不会被 ChatGPT、Claude、Perplexity 的回答引用 | 未核实:没有官方说明,我们也没有拿到实际引用的证据 | 我们没有调模型 |
所以目录页的价值,先按“让用户找到并装上”算,不按“让 AI 推荐你”算。AI 回答里能引用的东西,仍然是它能读到的网页:你的 README、官网页、目录页,写法见 {readme}。
server.json 和 README 第一段怎么写?
两处写同一句事实:这个服务器做什么、给 AI 开放哪些工具、怎么连、有什么前提。server.json 的 description 会被 registry 和下游目录原样显示,README 第一段会被 GitHub 页、npm 页和 Glama 这类目录渲染成正文,所以它们是读到你的人和程序最先看到的两段话。
| 不好的写法 | 好的写法 | |
|---|---|---|
| description | The ultimate AI-powered knowledge platform. Supercharge your workflow! | Search and read Markdown notes in a local folder. Read-only; Node.js 18+. |
| README 第一段 | 欢迎使用 Notes Search,一个强大而灵活的解决方案。 | 一句话说清它是什么,加工具数量、传输方式、运行环境和适用的客户端。 |
| 工具 | “多种强大工具” | 列出每个工具名和一句话:search_notes 搜笔记,read_note 读一篇。 |
# Notes Search MCP An MCP server that lets an AI assistant search and read the Markdown notes in a local folder. Read-only, two tools (search_notes, read_note), stdio transport, Node.js 18+. Works with any MCP client. ## Install npx -y @example/notes-search-mcp --dir ~/notes
再往下按顺序放:安装命令(npx 或 uvx 一行)、客户端配置片段、工具表、认证方式、已知限制。README 整体怎么写,见 {readme}。
该提交哪几个目录?
先交官方 registry,再按需要补第三方目录。下面是我们 2026-11-09 在各站看到的情况,提交条件以各站页面为准。
| 目录 | 我们看到的(2026-11-09) | 建议 |
|---|---|---|
| 官方 MCP Registry | 官方文档有完整发布流程;API 公开可读;审核宽松 | 必交,第一个做 |
| GitHub 仓库 | 仓库首页和 README 对三个爬虫都可抓;官方 servers 仓库说明它只放少量参考服务器,列表请去 Registry | 把 README 写好,加 topics;不要向官方 servers 仓库提交 |
| Glama(glama.ai/mcp/servers) | 页面写 118,135 个服务器,更新时间 2026-11-09;有 “Add Server” 入口 | 搜一下自己是否已被收录,没有再按它的入口提交;提交条件我们未核实 |
| mcp.so | 有 /submit 页;页面上有 39 美元一次性的付费提交选项,不付费时的审核方式页面没写清 | 可以提交;是否付费自己决定,付费对 AI 引用有没有帮助,未核实 |
| Smithery | 页面写 214 个服务器,顶部公告说 2026-10-31 关闭代理和账号,之后只保留由 Arcade.dev 支持的公开目录;/docs/build/publish 返回 404,我们没找到提交入口 | 不再当必交目录;想收录,先看它现在的说明 |
每交一个,就把条目网址记下来,放进自己的 README 和官网页,方便用户和爬虫从别处找到。榜单文章里的收录,见 怎么进「最佳 X 工具」榜单文章?。
自己官网要不要给每个服务器单独一页?
要。目录页都是别人的页面,描述可能被改写,样式和字段你也控制不了;官网上的一页是你完全控制的版本,也是 README 之外 AI 能读到的第二个来源。
1. 一个服务器一页,标题写成它能回答的问题
例如“怎么让 Claude 搜索本地 Markdown 笔记?”。第一段直接答:用 Notes Search MCP,两个工具,需要什么环境。
2. 放一张工具表
工具名、做什么、参数、是否只读。这张表是目录页和 README 里最容易被摘走的内容。
3. 放可复制的连接方式
stdio 服务器给 npx 命令和客户端配置;远程服务器给 URL 和认证方式。代码写成文本,不用截图。
4. 写清版本、日期和已知限制
版本号、最后更新日期、不支持的情况。
5. 链到 registry 条目和 GitHub
让官网页、registry 条目、README 互相链接,名称和描述保持一致。
文档类页面的整体写法,见 开发者文档怎么写,AI 才读得懂、引得到?;README 以外的包页、awesome 列表和发布说明,见 开源项目怎么被 AI 搜索推荐?README 以外的 6 个地方。
常见问题
MCP 服务器要发布到官方 registry 吗?
建议发布。官方文档写明它是公开 MCP 服务器的集中元数据库,下游目录站主要使用它;发布只需要 server.json、一个公开的包或公开的远程 URL,以及 mcp-publisher 命令行(2026-11-09 读)。它目前是 preview,规则可能变。
AI 爬虫能读 MCP 目录站吗?
从 robots.txt 看可以:2026-11-09 我们查的 Smithery、Glama、mcp.so 和 GitHub,没有一家按名字拦 GPTBot、ClaudeBot 或 PerplexityBot;官方 registry 的 robots.txt 返回 404。Glama 在 Content-Signal 里写了 ai-train=no。这只是 robots.txt 文字的判断。
目录页会被 ChatGPT 或 Claude 的回答引用吗?
我们没有官方说明,也没有拿到实际引用的证据,未核实。能确定的是页面描述在原始 HTML 里,爬虫读得到。
server.json 的 description 怎么写?
一句话写清做什么、开放哪些工具、运行环境。官方审核会删“描述里塞满营销话术、实现却无关”的服务器,所以不写口号。
私有或公司内部的 MCP 服务器能进 registry 吗?
不能。官方文档写明 registry 不支持私有服务器;内网的服务器也连不上 Claude 的自定义连接器,除非放行 Anthropic 的 IP 段。
提交 mcp.so 要付费吗?
它的 /submit 页(2026-11-09 所见)有一个 39 美元一次性的付费提交选项;不付费时怎么审核,页面没写清,我们未核实。
出处
- Model Context Protocol · The MCP Registry (查看于 2026-11-09)
- Model Context Protocol · Quickstart: Publish an MCP Server to the MCP Registry (查看于 2026-11-09)
- Model Context Protocol · MCP Registry Supported Package Types (查看于 2026-11-09)
- Model Context Protocol · The MCP Registry Moderation Policy (查看于 2026-11-09)
- Model Context Protocol · Consuming MCP Registry Aggregators (查看于 2026-11-09)
- Anthropic · Get started with custom connectors using remote MCP (查看于 2026-11-09)
- OpenAI · Building MCP servers for plugins and API integrations (查看于 2026-11-09)
- MCP Registry · GET /v0.1/servers (2026-11-09 读取)
- Glama · glama.ai/robots.txt (2026-11-09 读取)
- Smithery · smithery.ai/robots.txt (2026-11-09 读取)
- mcp.so · mcp.so/robots.txt (2026-11-09 读取)
- GitHub · modelcontextprotocol/servers (2026-11-09 读取)
- kagentx 评测:案例页的数据,日期写在每个例子里。