MCP Server Box

🚀 MCP 服務器箱中文翻譯

MCP 服務器箱是一個基於 Python 的項目，它與 Box API 集成，提供了文件搜索、文本提取、人工智能驅動特性以及文件上傳和下載等功能，能有效滿足用戶在文件管理和處理方面的需求。

🚀 快速開始

MCP 服務器箱是一個強大的工具，可幫助你高效地與 Box 雲存儲服務進行交互。以下是快速啟動項目的步驟：

1. 按照安裝指南完成項目的安裝和環境配置。
2. 啟動 MCP 服務器，開始使用各項功能。

✨ 主要特性

核心組件

• Box API 集成：藉助 box-sdk-gen 庫，實現與 Box 雲存儲服務的無縫交互。
• MCP 框架：基於模型上下文協議（Model Context Protocol），有效管理和協調不同模塊之間的通信。
• 豐富功能特性：
  • 文件搜索：能快速定位所需文件。
  • 文本提取：方便從文件中提取關鍵信息。
  • AI 驅動的特性：利用人工智能技術，提升處理效率。
  • 文件上傳和下載：輕鬆實現文件的上傳和下載操作。

📦 安裝指南

系統要求

• 操作系統：支持 MacOS/Linux 或 Windows。
• 內存：建議至少 2GB RAM。
• 其他：需安裝 Python 和 pip。

安裝步驟

1. 克隆倉庫

   git clone https://github.com/your-repository-url/mcp-server-box.git
   cd mcp-server-box
   

2. 安裝 uv 工具

   # 全局安裝 uv
   pip install uv
   
   # 創建和激活虛擬環境（MacOS/Linux）
   uv venv
   source .venv/bin/activate
   
   # 創建和激活虛擬環境（Windows）
   uv venv
   ./.venv/Scripts/activate
   

3. 鎖定依賴

   # 鎖定項目依賴
   uv lock
   
   # 安裝依賴到 virtualenv
   pip install -r requirements.txt
   

4. 配置環境變量 創建一個 .env 文件，並添加以下內容：

   BOX_CLIENT_ID=你的客戶端 ID
   BOX_CLIENT_SECRET=你的客戶端密鑰
   

💻 使用示例

啟動 MCP 服務器

uv --directory /Users/your-username/Desktop/mcp-server-box run src/mcp_server_box.py

配置 Claude 客戶端（可選）

1. 打開 Claude 的配置文件：

   code ~/Library/Application\ 支持/Claude/claude_desktop_config.json
   

2. 添加以下內容到 mcpServers 節點：

   {
       "mcp-server-box": {
           "command": "uv",
           "args": [
               "--directory",
               "/Users/your-username/Desktop/mcp-server-box",
               "run",
               "src/mcp_server_box.py"
           ]
       }
   }
   

3. 重啟 Claude 應用程序。

📚 詳細文檔

測試套件

準備測試環境

1. 更新文件和文件夾 ID：
   • 在 tests/ 目錄下的每個測試文件中，替換所有硬編碼的 Box 文件和文件夾 ID。
   • 示例：在 test_box_api_read.py 中，將 "1728677291168" 替換為你的 Box 賬戶中的一個有效文件 ID。
2. 測試用例說明：
   • test_box_auth.py：驗證身份驗證功能。
   • test_box_api_basic.py：測試基礎 Box API 功能。
   • test_box_api_read.py：測試文件讀取能力。
   • test_box_api_search.py：測試搜索功能。
   • test_box_api_ai.py：測試 AI 驅動的功能。
   • test_box_api_file_ops.py：測試文件上傳和下載操作。

執行測試

# 運行所有測試
pytest

# 運行特定測試文件
pytest tests/test_box_api_file_ops.py

# 以詳細模式運行測試
pytest -v

# 顯示打印輸出並運行測試
pytest -v -s

故障排除

常見問題

• 依賴未安裝：確保已正確安裝所有項目依賴。
• 環境變量配置錯誤：檢查 .env 文件中的 BOX_CLIENT_ID 和 BOX_CLIENT_SECRET 是否正確。
• 權限問題：確保你的 Box 賬戶擁有足夠的權限訪問測試文件。

解決方案

1. 重新安裝項目依賴：

   pip install -r requirements.txt
   

2. 驗證環境變量：

   echo $BOX_CLIENT_ID
   echo $BOX_CLIENT_SECRET
   

3. 檢查 Box 賬戶權限並更新測試文件中的 ID。

其他資源

• Box Developer Documentation
• uv 工具文檔
• Python 官方文檔