box-mcp-server

box-mcp-server

site icon
2025.03.07 6
JavaScript云存储文件管理文件管理
box-mcp-server 是一个用于与 Box 云存储服务集成的工具,主要提供文件搜索和读取功能。它支持通过 JSON Web Token (JWT) 或开发者令牌进行授权,适用于需要与 Box 服务交互的开发场景。
View on GitHub

Overview

基本能力

产品定位

box-mcp-server 是一个用于与 Box 云存储服务集成的工具,主要提供文件搜索和读取功能。

核心功能

  1. 文件搜索
  2. 文件读取(支持 PDF 和 Word 格式)

适用场景

  1. 需要与 Box 云存储服务集成的开发项目
  2. 需要自动化搜索和读取 Box 中文件的场景

工具列表

  1. JSON Web Token (JWT) 授权工具
  2. 提供持久连接 Box 的能力
  3. 开发者令牌授权工具
  4. 提供快速集成 Box 的能力,但令牌有效期仅 60 分钟

常见问题解答

  1. 如何获取 JWT?
  2. 需要付费的 Box 企业账户或免费开发者账户
  3. 在 Box 开发者控制台创建新应用并生成公钥/私钥对
  4. 如何 Base64 编码 JWT?
  5. 使用 cat /path/to/your/box-jwt-config.json | base64 命令

使用教程

使用依赖

  1. Node.js (推荐 v22 或更高版本)
  2. npm
  3. git
  4. dotenv

安装教程

  1. 克隆仓库 sh git clone https://github.com/YOUR_USERNAME/box-mcp-server.git cd box-mcp-server
  2. 添加上游远程 sh git remote add upstream https://github.com/hmk/box-mcp-server.git
  3. 复制 dotenv 文件 sh cp .env.template .env
  4. 安装依赖 sh npm install
  5. 运行 watch 保持 index.js 更新 sh npm run watch
  6. 启动模型上下文协议开发服务器 sh dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js

调试方式

  1. 如果开发服务器未正确加载环境变量,在 mcp inspector 的左侧设置 BOX_DEV_TOKEN

许可证

该项目遵循 BSD-3-Clause 开源许可条款,请参阅 BSD-3-Clause 了解完整条款。