box-mcp-server

box-mcp-server

使用方法

你需要：

• BOX_USER_ID

以及以下其中一项：

• BOX_JWT_BASE64（推荐）
• BOX_JWT_CONFIG_PATH
• BOX_JWT

身份验证

JSON Web Token（JWT）授权（推荐）

如何获取 JWT

使用 JWT 配置可以与 Box 建立持久连接。

你需要一个付费的 Box 企业账户，也可以注册一个免费的开发者账户（点击该链接前，请确保已退出 Box）。

访问 Box Developer Console 并创建一个新应用。请确保授权类型为 JSON Web Token。

前往 Configuration > Add and Manage Public Keys，生成公钥／私钥对。 如果你尚未完成这些步骤，Box 会提示你设置双重身份验证，并以管理员身份在你的 Box 账户中授权该应用。你需要：

1. 授予应用 App + Enterprise Access，并且
2. 启用 make API calls using the as-user header 选项

这些操作需在 Box 应用的 Configuration 页面中完成。修改这些设置后，请务必重新授权该应用。

对 JWT 进行 Base64 编码

要将 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 Developer Token。

请先访问 Box Developer Console 并创建一个新应用。目前授权类型无关紧要，因为所有类型都支持 Box Developer Token。

创建应用后，前往其配置设置并点击 Generate Developer Token。

Claude Desktop 配置

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

功能

1. 搜索文件
2. 读取文件

• PDF
• Word
• 其他

开发

先决条件

开始之前，请确保已安装以下内容：

• Node.js（建议使用 v22 或更高版本）
• npm
• git
• dotenv

设置开发环境

按照以下步骤设置开发环境：

1. Fork 此仓库

   • 点击此仓库右上角的“Fork”按钮
   • 这会在你的 Github acocunt 下创建一份仓库副本

2. 克隆你的 Fork：

   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. 运行 watch，以保持 index.js 更新：

   npm run watch
   

7. 启动模型上下文协议开发服务：

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

8. 如果开发服务未能正确加载环境变量，请在 MCP Inspector 左侧设置 BOX_DEV_TOKEN。