box-mcp-服务器

用法

您将需要：

BOX_USER_ID

以及下列之一：

BOX_JWT_BASE64 （推荐）
BOX_JWT_CONFIG_PATH
BOX_JWT

Related MCP server: Google Drive server

授权

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

如何获取 JWT

使用 JWT 配置可以实现与 Box 的持久连接。

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

访问Box 开发者控制台并创建一个新的应用程序。确保授权类型为 JSON Web Token。

前往Configuration > Add and Manage Public Keys ，并生成公钥/私钥对。如果您尚未设置，Box 会提示您设置双因素身份验证，并在您的 Box 帐户中以管理员身份授权该应用程序。您需要执行以下操作：

授予应用程序App + Enterprise Access ，并且
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 开发者令牌。

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

Claude桌面配置

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

功能

搜索文件
读取文件

[x] PDF
[x] 字
[ ] 其他的

发展

先决条件

开始之前，请确保已安装以下软件：

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

设置开发环境

要设置开发环境，请按照以下步骤操作：

分叉存储库
- 点击此仓库右上角的“Fork”按钮
- 这将在您的 Github 帐户下创建您自己的存储库副本
克隆你的 Fork：
git clone https://github.com/YOUR_USERNAME/box-mcp-server.git cd box-mcp-server
添加上游远程
git remote add upstream https://github.com/hmk/box-mcp-server.git
复制 dotenv 文件
cp .env.template .env
安装依赖项：
npm install
运行 watch 来保持 index.js 更新：
npm run watch
启动模型上下文协议开发服务器：
dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js
如果开发服务器未正确加载环境变量，请在 mcp 检查器的左侧设置BOX_DEV_TOKEN 。