跳至主要內容

本地 MCP 伺服器提交指南

今日已更新

這是一份完整指南,用於將您的本地伺服器 (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/

# 驗證每個工具是否恰好有一個註解

是否回答了您的問題?