# Box文档管理服务器
## 基本信息
- Slug: `hmk-box-mcp-server`
- Source: modelscope
- Publisher: @hmk/box-mcp-server
- Categories: file-systems / cloud-storage / developer-tools
- Hosted: No
- License: BSD 3-Clause "New" or "Revised" License
- Source URL: https://www.modelscope.cn/mcp/servers/@hmk/box-mcp-server
## 简介
Box MCP服务器通过开发人员令牌身份验证，方便在Box中搜索和阅读PDF及Word文件。
## 安装提示

```bash
cat /path/to/your/box-jwt-config.json | base64 ``` 将 `/path/to/your/box-jwt-config.json` 替换为您实际的 JWT 配置文件路径。这将输出 Base64 编码的 JWT，然后您可以在环境变量中使用它。 #### Claude 桌面配置 ```json { "mcpServers": { "box": { "command": "npx", "args": ["box-mcp-server"], "env": { "BOX_JWT_BASE64": "YOUR_BASE64_ENCODED_JWT", "BOX_USER_ID": "123456" } } } }
```

## MCP Server 详情

# box-mcp-server

![CI](https://github.com/hmk/box-mcp-server/actions/workflows/jest.yml/badge.svg?branch=main)

## 用法

您需要：

- `BOX_USER_ID` 

以及以下之一：

- `BOX_JWT_BASE64`（推荐）
- `BOX_JWT_CONFIG_PATH`
- `BOX_JWT`

## 认证

### JSON Web Token (JWT) 授权（推荐）

#### 如何获取 JWT

使用 JWT 配置可以实现与 Box 的持久连接。

您需要一个付费的 Box 企业账户，或者您可以注册一个 [免费开发者账户](https://account.box.com/signup/n/developer)（在点击该链接之前，请确保您已从 Box 登出）。

访问 [Box 开发者控制台](https://app.box.com/developers/console) 并创建一个新的应用程序。确保授权类型为 JSON Web Token。

转到 `配置 > 添加和管理公钥` 并生成一个公私钥对。
如果您还没有设置，Box 会提示您设置两步验证，并在您的 Box 账户中以管理员身份授权该应用程序。您需要：

1. 给予应用程序 `App + 企业访问权限`，并且
2. 启用 `使用 as-user 头进行 API 调用` 选项

通过 Box 应用程序的配置页面。**如果您正在修改这些设置，请确保重新授权应用程序**。

#### Base64 编码 JWT

要将您的 JWT 编码为 Base64，可以在终端中使用以下命令：

```sh
cat /path/to/your/box-jwt-config.json | base64
```


将 `/path/to/your/box-jwt-config.json` 替换为您实际的 JWT 配置文件路径。这将输出 Base64 编码的 JWT，然后您可以在环境变量中使用它。

#### Claude 桌面配置

```json
{
  "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 开发者令牌](https://developer.box.com/guides/authentication/tokens/developer-tokens/)。

首先访问 [Box 开发者控制台](https://app.box.com/developers/console) 并创建一个新的应用程序。目前授权类型无关紧要，因为所有都支持 Box 开发者令牌。

创建应用程序后，导航到其配置设置并点击 `生成开发者令牌`。

#### Claude 桌面配置

```json
{
  "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
- git
- dotenv

### 设置开发环境

要设置开发环境，请按照以下步骤操作：

1. Fork 仓库

   - 点击此仓库右上角的“Fork”按钮
   - 这将在您的 Github 账户下创建一个仓库副本

1. 克隆您的 Fork：

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

1. 添加上游远程仓库
   ```sh
   git remote add upstream https://github.com/hmk/box-mcp-server.git
   ```

1. 复制 dotenv 文件
    ```sh
    cp .env.template .env
    ```

1. 安装依赖项：

   ```sh
   npm install
   ```

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

   ```sh
   npm run watch
   ```

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

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

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