box-mcp-server

基本能力

产品定位

box-mcp-server 是一个基于 Box 开发者令牌认证的 MCP 服务器，主要用于文件搜索和读取。

核心功能

1. 搜索文件
2. 读取文件
3. 支持 PDF
4. 支持 Word
5. 不支持其他格式

适用场景

• 需要集成 Box 文件管理功能的开发场景
• 需要从 Box 中搜索和读取 PDF 或 Word 文件的应用程序

工具列表

• Box Developer Token: 用于认证和授权
• Node.js 和 npm: 用于运行和开发
• git: 用于版本控制

常见问题解答

1. 如何获取 Box Developer Token？
2. 访问 Box Developer Console 创建新应用并生成开发者令牌。
3. 如何设置环境变量？
4. 使用 export BOX_DEV_TOKEN=your_developer_token 命令设置环境变量。
5. 如何启动开发服务器？
6. 使用 npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js 命令启动开发服务器。

使用教程

使用依赖

在开始之前，请确保已安装以下依赖：

• Node.js (v22 或更高版本)
• npm
• git

安装教程

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. 安装依赖： sh npm install
4. 设置环境变量： sh export BOX_DEV_TOKEN=your_developer_token
5. 运行 watch 以保持 index.js 更新： sh npm run watch
6. 启动模型上下文协议开发服务器： sh npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js

调试方式

1. 如果开发服务器未正确加载环境变量，请在 mcp inspector 的左侧设置 BOX_DEV_TOKEN。
2. 使用 npm run watch 命令实时更新代码。

许可证

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