Box MCP Server

box-mcp服务器

用法

您将需要：

• BOX_USER_ID

以及以下之一：

• BOX_JWT_BASE64 （推荐）
• BOX_JWT_CONFIG_PATH
• BOX_JWT

认证

JSON Web令牌（JWT）授权（推荐）

如何获得JWT

使用JWT配置允许与Box的持久连接。

您需要一个付费的Box企业帐户，或者您可以注册一个 免费开发者帐户 （在单击该链接之前，请确保您已退出Box）。

访问 Box开发人员控制台 并创建新的应用程序。确保授权类型为JSON Web令牌。

首选 Configuration > Add and Manage Public Keys 并生成公钥/私钥对。 如果您还没有，Box会提示您设置双因素身份验证，并在您的Box帐户中以管理员身份授权应用程序。您需要：

1. 提交申请 App + Enterprise Access，以及
2. 启用 make API calls using the as-user header 选项

通过Box应用程序的配置页面。 如果要修改这些设置，请确保重新授权应用程序.

Base64编码JWT

要在Base64中编码JWT，您可以在终端中使用以下命令：

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

替换 /path/to/your/box-jwt-config.json 使用JWT配置文件的实际路径。这将输出Base64编码的JWT，然后您可以在环境变量中使用它。

Claude桌面配置

{
  "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 Developer Token。

创建应用程序后，导航到其配置集并单击 Generate Developer Token.

Claude桌面配置

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

能力

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

• \[x\] PDF
• \[x\] Word
• \[\]其他

发展

先决条件

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

• Node.js（推荐v22或更高版本）
• npm
• 版本控制系统
• dotenv

建立开发环境

要设置开发环境，请执行以下步骤：

1. 分叉存储库

- 单击此存储库右上角的“Fork”按钮 - 这将在您的Github acocunt下创建您自己的存储库副本

1. 克隆你的叉子：

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

1. 添加上游遥控器

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

1. 复制dotenv文件

   cp .env.template .env

1. 安装依赖项：

   npm install

1. 运行watch以保持index.js更新：

   npm run watch

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

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

1. 如果开发服务器没有正确加载环境变量，请设置 BOX_DEV_TOKEN 在mcp检查员的左侧。