box-mcp-server

概述

Box MCP Server 是一个模型上下文协议服务器，允许您搜索并访问存储在 Box 中的文件。

必要凭据

您需要：

• BOX_USER_ID

以及以下认证方式之一：

• BOX_JWT_BASE64（推荐 - 持久连接）
• BOX_DEV_TOKEN（简单但仅有效60分钟）

设置指南

方法1：JWT认证（推荐）

1. 注册 Box 企业账户或开发者账户
2. 在 Box 开发者控制台 创建应用，授权类型选择 JWT
3. 生成公钥/私钥对并下载 JWT 配置文件
4. 启用 App + Enterprise Access 权限和 使用 as-user 标头进行 API 调用
5. 将 JWT 配置文件转为 Base64 格式：

   cat box-jwt-config.json | base64
   

6. 在 Claude 桌面配置中设置：

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

方法2：开发者令牌（简单但短期）

1. 在 Box 开发者控制台 创建应用
2. 在应用配置中点击 生成开发者令牌
3. 在 Claude 桌面配置中设置：

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

功能

• 搜索文件：查找 Box 中的文件
• 读取文件：支持 PDF、Word 和其他格式

开发环境设置

1. Fork 并克隆仓库：

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

2. 设置环境：

   git remote add upstream https://github.com/hmk/box-mcp-server.git
   cp .env.template .env
   npm install
   

3. 运行开发服务器：

   npm run watch
   dotenv npx @modelcontextprotocol/inspector node dist/index.js