本指南將幫助您建立 MCP Bundle (.mcpb) 以建立供內部使用、私人發佈的桌面擴充功能,或作為提交至 Anthropic 連接器目錄的基礎。
1. 簡介
什麼是 MCPB?
MCPB (.mcpb) 檔案是包含本機 MCP 伺服器和 manifest.json 的 zip 壓縮檔。它們可在 Claude Desktop 中進行單鍵安裝,類似於瀏覽器擴充功能。
主要特性:
在使用者的機器上本機執行
透過 stdio 傳輸進行通訊
捆綁所有依賴項
離線工作
不需要 OAuth
深入了解:
MCPB 儲存庫 - 完整規格和架構
桌面擴充功能部落格文章 - 概述和使用案例
何時應使用本機伺服器 (MCPB) 與遠端伺服器?
在以下情況選擇本機伺服器 (MCPB):
內部系統和安全性
存取防火牆後的系統 (JIRA、Confluence、內部 wiki、私人資料庫)
無縫驗證 - 自動使用現有 SSO 和瀏覽器工作階段,無需權杖管理
零信任合規性 - 在公司網路邊界內運作,無需公開公開內部資源
本機資源
直接檔案系統存取以進行程式碼編輯和 Git 操作
與本機安裝的工具整合 (Docker、IDE、資料庫)
硬體整合和桌面應用程式控制
不應離開使用者機器的隱私敏感操作
企業部署
單鍵安裝,內建 Node.js 執行時 (無需管理依賴項)
無需雲端基礎設施、VPN 設定或防火牆規則
組織級控制 - 管理員可上傳自訂擴充功能並透過允許清單管理存取
完全控制驗證、授權和稽核日誌
在以下情況選擇遠端連接器:
需要集中式基礎設施的雲端服務和公開 API
跨 Claude 網頁版、行動版和桌面版發佈
需要跨所有使用者進行集中式更新的服務
需要伺服器端權杖管理的 OAuth 流程
多個組織使用的公開整合
主要差異:MCPB 透過 stdio 傳輸在使用者的機器上執行,可存取本機和內部資源。遠端連接器在您的伺服器上透過 HTTPS 執行,並透過 Anthropic 的基礎設施存取。
實際應用:組織正在建立 MCPB 作為內部 MCP 伺服器的安全代理、用於內部文件存取,以及連接開發工具,同時維持其安全架構。
遠端連接器指南:請參閱 MCP 合作夥伴常見問題以取得完整的遠端連接器文件。
2. 開始使用
我應該使用哪種程式設計語言?
強烈建議使用 Node.js,原因如下:
隨 Claude macOS 和 Windows 版本一起提供 (使用者零安裝摩擦)
使用者無需單獨安裝執行時
與 Claude Desktop 的最佳相容性和可靠性
廣泛的 MCP SDK 支援
我應該支援哪些平台?
Claude Desktop 執行於:
macOS (darwin)
Windows (win32)
在 manifest.json 相容性部分中指定支援的平台。
最佳實踐:即使您主要在一個平台上開發,也應在兩個平台上進行測試。
平台相容性詳情:請參閱 MCPB 清單規格 - 相容性以了解平台規格和執行時要求。
我如何建立我的第一個 MCPB?
遵循以下五個步驟的流程:
1. 安裝 MCPB CLI:npm install -g @anthropic-ai/mcpb
2. 建立您的 MCP 伺服器 (請參閱 MCP SDK)
3. 執行 mcpb init 以建立 manifest.json
4. 執行 mcpb pack 以進行捆綁
5. 在 Claude Desktop 中安裝並測試
