Box

官方

透過 Box AI 與智慧內容管理平台互動。

GitHub

102

你可以用 Box MCP 做什麼？

搜尋檔案和資料夾 — 使用 box_tools_search 依關鍵字、檔案類型或元資料在 Box 中尋找內容。
列出、建立或管理資料夾 — 使用 box_tools_folders 瀏覽資料夾內容、建立新資料夾，或更新和刪除現有資料夾。
讀取、上傳或下載檔案 — 透過 box_tools_files 擷取檔案內容、上傳新版本或下載檔案。
管理共用連結 — 使用 box_tools_shared_links 建立、更新或移除檔案、資料夾和網頁連結的共用連結。
使用 AI 查詢檔案 — 透過 box_tools_ai 詢問關於檔案內容或中樞資料的問題。
處理元資料範本 — 使用 box_tools_metadata 建立和管理元資料範本，並將實例值套用至檔案。

文件

Box MCP 伺服器

[!WARNING] 此儲存庫已停止開發且不再維護。 Box 現已提供官方支援的託管式 MCP 伺服器，具備最佳體驗與完整功能。請遷移至託管式 MCP 伺服器：設定 Box MCP 伺服器 →

快速入門

複製儲存庫：

git clone https://github.com/box-community/mcp-server-box.git
cd mcp-server-box

可選但建議安裝 `uv` 用於虛擬環境與相依性管理：

Homebrew (macOS)

brew install uv

WinGet (Windows)

winget install --id=astral-sh.uv  -e

在 macOS 與 Linux 上

curl -LsSf https://astral.sh/uv/install.sh | sh

在 Windows 上

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

設定虛擬環境並安裝相依套件：

uv sync

設定環境變數：

在 .env 檔案或您的系統環境中設定下列用於 Box 驗證的環境變數。

如需完整的驗證設定選項，請參閱驗證指南。

使用 OAuth2.0 搭配 Box 應用程式

BOX_CLIENT_ID = YOUR_CLIENT_ID
BOX_CLIENT_SECRET = YOUR_CLIENT_SECRET
BOX_REDIRECT_URL = http://localhost:8000/callback

# MCP Server Authentication (for HTTP transports)
BOX_MCP_SERVER_AUTH_TOKEN = YOUR_BOX_MCP_SERVER_AUTH_TOKEN
OAUTH_PROTECTED_RESOURCES_CONFIG_FILE = .oauth-protected-resource.json

注意：

使用 --mcp-auth-type=token 時，BOX_MCP_SERVER_AUTH_TOKEN 用於向 MCP 伺服器驗證 MCP 用戶端（獨立於 Box 驗證）

以 STDIO 模式執行 MCP 伺服器：

uv run src/mcp_server_box.py

Box 社群 MCP 伺服器工具

以下是可用工具的摘要：

可用工具	說明
box_tools_ai	AI 驅動的檔案與中心查詢
box_tools_collaboration	管理檔案/資料夾協作
box_tools_docgen	文件產生與範本管理
box_tools_files	檔案操作（讀取、上傳、下載）
box_tools_folders	資料夾操作（列出、建立、刪除、更新）
box_tools_generic	通用 Box API 工具
box_tools_groups	群組管理與查詢
box_tools_metadata	中繼資料範本與實例管理
box_tools_search	搜尋檔案與資料夾
box_tools_shared_links	檔案/資料夾/網頁連結的共享連結管理
box_tools_tasks	任務與任務指派管理
box_tools_users	使用者管理與查詢
box_tools_web_link	網頁連結建立與管理

Box 社群 MCP 伺服器操作詳細資訊

命令列介面參數

若要使用特定設定執行 MCP 伺服器，您可以使用下列命令列參數：

uv run src/mcp_server_box.py --help

usage: mcp_server_box.py [-h] [--transport {stdio,sse,http}] [--host HOST] [--port PORT] [--mcp-auth-type {oauth,token,none}] [--box-auth-type {oauth,ccg,jwt,mcp_client}]

Box Community MCP Server

options:
  -h, --help            show this help message and exit
  --transport {stdio,sse,http}
                        Transport type (default: stdio)
  --host HOST           Host for SSE/HTTP transport (default: localhost)
  --port PORT           Port for SSE/HTTP transport (default: 8005)
  --mcp-auth-type {oauth,token,none}
                        Authentication type for MCP server (default: token)
  --box-auth-type {oauth,ccg,jwt,mcp_client}
                        Authentication type for Box API (default: oauth)

如需驗證類型、設定與使用案例的詳細資訊，請參閱驗證指南。

Claude 桌面設定

STDIO 模式

編輯您的 claude_desktop_config.json：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Add the configuration:

{
    "mcpServers": {
        "mcp-server-box": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-server-box",
                "run",
                "src/mcp_server_box.py"
            ]
        }
    }
}

若 Claude 正在執行，請重新啟動。

HTTP 模式

假設您的 MCP 伺服器正在 https://mcp.myserver.com/mcp 上執行

前往 Claude -> 設定 -> 連接器
選取 Add custom connector
設定：
1. 為其命名
2. 輸入 URL，例如 https://mcp.myserver.com/mcp
3. 可選擇輸入 client id 與 client secret
點擊新增
點擊連線。OAuth 流程應會啟動。完成流程
返回 Claude，點擊設定。您應會看到所有可用工具。

Box