Box Community MCP Server Box

🚀 MCP Server Box項目

MCP Server Box 是一個 Python 項目，它與 Box API 集成，可執行文件搜索、文本提取、基於 AI 的查詢和數據提取等操作。該項目藉助 box-sdk-gen 庫，提供了一系列工具，能交互式地處理 Box 文件和文件夾。

模型上下文協議 (MCP) 作為一個框架，旨在標準化模型與多種數據源和服務之間的交互方式。在此項目裡，MCP 用於促進與 Box API 的無縫集成，實現對 Box 文件和文件夾的高效且可擴展操作。MCP Server Box 項目致力於提供一個強大且靈活的解決方案，用於運用高級 AI 和機器學習技術管理和處理 Box 數據。

🚀 快速開始

先決條件

• Python 3.13 或更高版本
• Box API 憑據（客戶端 ID、客戶端秘密等）

安裝

1. 克隆倉庫：

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

2. 若尚未安裝，請安裝 uv：
   • MacOS+Linux

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

- **Windows**

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

3. 創建並設置項目：
   • MacOS+Linux

# 創建虛擬環境並激活它
uv venv
source .venv/bin/activate

# 鎖定依賴項
uv lock

- **Windows**

# 創建虛擬環境並激活它
uv venv
.venv\Scripts\activate

# 鎖定依賴項
uv lock

4. 在項目根目錄中創建一個 .env 文件，並添加您的 Box API 憑據：

BOX_CLIENT_ID=your_client_id
BOX_CLIENT_SECRET=your_client_secret

使用方法

運行 MCP 服務器

要啟動 MCP 服務器，請運行以下命令：

uv --directory /path-to-the-project/mcp-server-box run src/mcp_server_box.py

使用 Claude 作為客戶端

1. 編輯您的 claude_desktop_config.json 文件

code ~/Library/Application\ Support/Claude/cla

✨ 主要特性

本項目實現了一系列實用工具，具體如下：

box_who_am_i

獲取當前用戶信息並檢查連接狀態。 返回：用戶信息字符串

box_authorize_app_tool

啟動 Box 應用授權過程。 返回：授權狀態消息

box_search_tool

在 Box 中搜索文件。 參數：

• query (str)：搜索查詢
• file_extensions (List[str], 可選)：過濾的文件擴展名
• where_to_look_for_query (List[str], 可選)：搜索位置（NAME, DESCRIPTION, FILE_CONTENT, COMMENTS, TAG）
• ancestor_folder_ids (List[str], 可選)：在哪個文件夾內搜索 返回：搜索結果

box_read_tool

讀取 Box 文件的文本內容。 參數：

• file_id (str)：要讀取的文件 ID 返回：文件內容

box_ask_ai_tool

向 Box AI 關於一個文件提問。 參數：

• file_id (str)：文件 ID
• prompt (str)：提問給 AI 的問題 返回：AI 回應

box_search_folder_by_name

通過名稱定位文件夾。 參數：

• folder_name (str)：文件夾名稱 返回：文件夾 ID

box_ai_extract_data

使用 AI 從文件中提取數據。 參數：

• file_id (str)：文件 ID
• fields (str)：要提取的字段 返回：JSON 格式的提取數據

box_list_folder_content_by_folder_id

列出文件夾內容。 參數：

• folder_id (str)：文件夾 ID
• is_recursive (bool)：是否遞歸列出 返回：JSON 格式文件夾內容，包含 id、名稱、類型和描述