
box-mcp-server

2025.03.07
6
JavaScript云存储文件管理文件管理
box-mcp-server 是一个用于与 Box 云存储服务集成的工具,主要提供文件搜索和读取功能。它支持通过 JSON Web Token (JWT) 或开发者令牌进行授权,适用于需要与 Box 服务交互的开发场景。
View on GitHub
Overview
基本能力
产品定位
box-mcp-server 是一个用于与 Box 云存储服务集成的工具,主要提供文件搜索和读取功能。
核心功能
- 文件搜索
- 文件读取(支持 PDF 和 Word 格式)
适用场景
- 需要与 Box 云存储服务集成的开发项目
- 需要自动化搜索和读取 Box 中文件的场景
工具列表
- JSON Web Token (JWT) 授权工具
- 提供持久连接 Box 的能力
- 开发者令牌授权工具
- 提供快速集成 Box 的能力,但令牌有效期仅 60 分钟
常见问题解答
- 如何获取 JWT?
- 需要付费的 Box 企业账户或免费开发者账户
- 在 Box 开发者控制台创建新应用并生成公钥/私钥对
- 如何 Base64 编码 JWT?
- 使用
cat /path/to/your/box-jwt-config.json | base64
命令
使用教程
使用依赖
- Node.js (推荐 v22 或更高版本)
- npm
- git
- dotenv
安装教程
- 克隆仓库
sh git clone https://github.com/YOUR_USERNAME/box-mcp-server.git cd box-mcp-server
- 添加上游远程
sh git remote add upstream https://github.com/hmk/box-mcp-server.git
- 复制 dotenv 文件
sh cp .env.template .env
- 安装依赖
sh npm install
- 运行 watch 保持 index.js 更新
sh npm run watch
- 启动模型上下文协议开发服务器
sh dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js
调试方式
- 如果开发服务器未正确加载环境变量,在 mcp inspector 的左侧设置
BOX_DEV_TOKEN
。