這是一份完整指南,用於將您的本地伺服器 (MCPB) 提交到 Anthropic 的公開目錄,以便更廣泛的分發和發現。
先決條件
閱讀本指南前,您應該具備:
一個可運作的 MCPB
使用變數替換的可移植程式碼
良好的錯誤訊息和使用者體驗
乾淨、捆綁的依賴項
初次接觸 MCPB 開發?請先參閱使用 MCPB 構建桌面擴充功能。如需技術最佳實踐(測試、錯誤訊息、可移植性),請參閱MCPB 儲存庫。
注意:本指南涵蓋本地 MCP 伺服器。如需遠端桌面擴充功能,請參閱遠端 MCP 伺服器提交指南。
1. 目錄概述
目錄收錄有什麼好處?
可發現性和信任:
在 Claude Desktop 內的官方 Anthropic 目錄中列出
可由個別 Claude Desktop 使用者搜尋
當管理員將其新增到允許清單時,對 Teams/Enterprise 使用者可見
Anthropic 審查建立使用者信任
使用者體驗:
從目錄一鍵安裝
與 Claude Desktop 設定 UI 整合
標準化呈現
支援和信譽:
Anthropic 對品質和安全性的審查
與其他已審查的擴充功能並列
社群可見性和反饋
專業分發管道
2. 強制性要求
本部分中的所有要求對於目錄批准都是強制性的。缺少其中任何一項將導致拒絕或修訂請求。
注意:這些是 Anthropic 目錄特定的要求。
如需一般 MCPB 開發最佳實踐(測試、錯誤處理、可移植性),請參閱MCPB 儲存庫 README。
工具註解是否為必需?
是的。每個工具都必須具有並維護準確的安全註解。
每個工具上的必需項:
readOnlyHint: true - 適用於僅讀取資料的工具
destructiveHint: true - 適用於修改資料或有副作用的工具
請參閱MCP 協議 - 工具註解以了解完整的架構和實作詳情。
非可選項。這是源自MCP 目錄政策的硬性要求。
如何決定使用哪個註解:
工具行為 | 註解 | 範例 |
僅讀取資料 | readOnlyHint: true | search、get、list、fetch、read |
寫入/修改資料 | destructiveHint: true | create、update、delete、send、write |
建立臨時檔案 | destructiveHint: true | 即使是臨時寫入也算 |
傳送外部請求 | destructiveHint: true | 電子郵件、通知、Webhook |
僅內部快取 | readOnlyHint: true | 內部最佳化可以 |
實作詳情:請參閱MCP 協議 - 工具以了解:
帶有註解的完整工具架構
工具定義結構
輸入/輸出架構規格
其他工具屬性(包括可選的 title 欄位)
提交前驗證:
# 檢查所有工具是否有註解
grep -A 5 -B 5 "readOnlyHint\|destructiveHint" server/
# 驗證每個工具是否恰好有一個註解
