AI导哈

Box文件管理服务

一个基于Box API的文件搜索和读取服务，支持PDF和Word格式，适用于企业文件管理和开发集成。

  • by hmk
  • JavaScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 hmk/box-mcp-server

使用说明

box-mcp服务器

用法

您将需要：

  • BOX_USER_ID

以及以下之一：

  • BOX_JWT_BASE64 （推荐）
  • BOX_JWT_CONFIG_PATH
  • BOX_JWT

认证

JSON Web令牌（JWT）授权（推荐）

如何获得JWT

使用JWT配置允许与Box的持久连接。

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

访问 Box开发人员控制台 并创建新的应用程序。确保授权类型为JSON Web令牌。

首选 Configuration > Add and Manage Public Keys 并生成公钥/私钥对。 如果您还没有，Box会提示您设置双因素身份验证，并在您的Box帐户中以管理员身份授权应用程序。您需要：

  1. 提交申请 App + Enterprise Access，以及
  2. 启用 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 Developer Token。

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

Claude桌面配置

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

能力

  1. 搜索文件
  2. 正在读取文件
  • [x] PDF
  • [x] Word
  • []其他

发展

先决条件

在开始之前，请确保已安装以下内容：

  • Node.js（推荐v22或更高版本）
  • npm
  • 版本控制系统
  • dotenv

建立开发环境

要设置开发环境，请执行以下步骤：

  1. 分叉存储库

    • 单击此存储库右上角的“Fork”按钮
    • 这将在您的Github acocunt下创建您自己的存储库副本

  2. 克隆你的叉子：

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

  3. 添加上游遥控器

    git remote add upstream https://github.com/hmk/box-mcp-server.git

  4. 复制dotenv文件

    cp .env.template .env

  5. 安装依赖项：

    npm install

  6. 运行watch以保持index.js更新：

    npm run watch

  7. 启动模型上下文协议开发服务器：

    dotenv npx @modelcontextprotocol/inspector node PATH_TO_YOUR_CLONED_REPO/dist/index.js

  8. 如果开发服务器没有正确加载环境变量，请设置 BOX_DEV_TOKEN 在mcp检查员的左侧。

相关 MCP