Box MCP Server

🚀 box-mcp-server

box-mcp-server 是一個用於與 Box 平臺進行交互的服務器，支持多種認證方式，可實現文件搜索和讀取等功能。

🚀 快速開始

你需要配置以下環境變量：

• BOX_USER_ID

以及以下其中一種方式之一：

• BOX_JWT_BASE64（推薦）
• BOX_JWT_CONFIG_PATH
• BOX_JWT

✨ 主要特性

1. 搜索文件：可在 Box 平臺上搜索文件。
2. 讀取文件：支持讀取 PDF 和 Word 格式的文件，其他格式待支持。
   • [x] PDF
   • [x] Word
   • [ ] 其他

📦 安裝指南

先決條件

在開始之前，請確保你已安裝以下軟件：

• Node.js（推薦 v22 或更高版本）
• npm
• git
• dotenv

設置開發環境

要設置開發環境，請按照以下步驟操作：

1. 叉克倉庫
   • 點擊此倉庫右上角的“叉克”按鈕。
   • 這會在你自己的 Github 賬戶下創建該倉庫的副本。
2. 克隆你的副本

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

3. 添加上游遠程倉庫

   git remote add upstream https://github.com/hmk/box-mcp-server.git
   

4. 複製 dotenv 文件

   cp .env.template .env
   

5. 安裝依賴

   npm install
   

6. 運行看門狗以保持 index.js 更新

   npm run watch
   

7. 啟動模型上下文協議開發服務器

   dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js
   

8. 環境變量加載問題處理 如果開發服務器未能正確加載環境變量，請在 mcp 檢查器的左側設置 BOX_DEV_TOKEN。

📚 詳細文檔

認證

JSON Web Token (JWT) 授權（推薦）

使用 JWT 配置可以實現與 Box 的持久連接。你需要一個付費的 Box 企業賬戶，或者你可以註冊一個免費開發者賬戶（請確保在點擊該鏈接之前已退出 Box）。訪問 Box 開發者控制檯，創建一個新的應用程序。如果你還沒有設置，請確保你已經設置了雙重因素認證，並且作為管理員在你的 Box 賬戶中授權該應用。你需要：

1. 給應用程序授予 App + 企業訪問 權限。
2. 啟用 使用 as-user 標頭進行 API 調用 選項。

通過 Box 應用的配置頁面。如果你修改了這些設置，請確保重新授權該應用。

如何獲取 JWT

要對你的 JWT 進行 Base64 編碼，可以在終端中使用以下命令：

cat /path/to/your/box-jwt-config.json | base64

將 /path/to/your/box-jwt-config.json 替換為你實際的 JWT 配置文件路徑。這會輸出 Base64 編碼的 JWT，你可以將其用於環境變量。

Claude Desktop 配置

{
  "mcpServers": {
    "box": {
      "command": "npx",
      "args": ["box-mcp-server"],
      "env": {
        "BOX_JWT_BASE64": "YOUR_BASE64_ENCODED_JWT",
        "BOX_USER_ID": "123456"
      }
    }
  }
}

開發者令牌授權（最簡單）

使用開發者令牌是與 Box 集成的最簡單方式，但僅持續 60 分鐘。要開始，請將 BOX_DEV_TOKEN 設置為一個Box 開發者令牌。

首先訪問 Box 開發者控制檯，創建一個新的應用程序。此時授權類型並不重要，因為所有支持 Box 開發者令牌的應用程序都會被支持。一旦你的應用程序創建完成，請導航到其配置設置並點擊 生成開發者令牌。

Claude Desktop 配置

{
  "mcpServers": {
    "box": {
      "command": "npx",
      "args": ["box-mcp-server"],
      "env": {
        "BOX_DEV_TOKEN": "YOUR_DEV_TOKEN_GOES_HERE"
      }
    }
  }
}