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 評測:案例頁的資料,日期寫在每個例子裡。