跳至主要內容

使用 MCPB 構建桌面擴展

今日已更新

本指南將幫助您建立 MCP Bundle (.mcpb) 以建立供內部使用、私人發佈的桌面擴充功能,或作為提交至 Anthropic 連接器目錄的基礎。


1. 簡介

什麼是 MCPB?

MCPB (.mcpb) 檔案是包含本機 MCP 伺服器和 manifest.json 的 zip 壓縮檔。它們可在 Claude Desktop 中進行單鍵安裝,類似於瀏覽器擴充功能。

主要特性:

  • 在使用者的機器上本機執行

  • 透過 stdio 傳輸進行通訊

  • 捆綁所有依賴項

  • 離線工作

  • 不需要 OAuth

深入了解:


何時應使用本機伺服器 (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 中安裝並測試

是否回答了您的問題?