关键词

Box云存储文件搜索文档读取LLM工具

使用说明

项目简介

Box MCP服务器是一个基于Model Context Protocol (MCP) 的应用后端，它允许LLM客户端安全访问和操作存储在Box云存储平台上的文件。通过此服务器，LLM可以搜索Box中的文件，并读取包括PDF、Word文档和文本文档在内的多种文件内容。

主要功能点

  • 文件搜索：支持在整个Box云存储空间中搜索文件和文件夹。
  • 文件读取：支持读取多种文件格式，包括PDF、Word文档（doc, docx）和文本文档（txt, md, json, csv）。

安装步骤

  1. 克隆仓库： 
    git clone https://github.com/hmk/box-mcp-server.git
  2. 进入仓库目录： 
    cd box-mcp-server
  3. 安装依赖： 
    npm install

服务器配置

以下是 Claude Desktop 客户端的 MCP 服务器配置示例，用于连接 Box MCP 服务器。您需要在 'env' 部分配置 Box 认证信息。

{
  "mcpServers": {
    "box": {
      "command": "npx",
      "args": ["box-mcp-server"],
      "env": {
        "BOX_DEV_TOKEN": "YOUR_DEV_TOKEN_GOES_HERE"
        // 或者使用 JWT 认证 (推荐):
        // "BOX_JWT_BASE64": "YOUR_BASE64_ENCODED_JWT",
        // "BOX_USER_ID": "YOUR_BOX_USER_ID"
      }
    }
  }
}
  • 'command': 运行 MCP 服务器的命令，这里使用 'npx' 执行 'box-mcp-server' 包。
  • 'args': 传递给命令的参数，这里为空数组。
  • 'env': 环境变量配置，用于 Box 认证：
    • 'BOX_DEV_TOKEN': Box 开发者令牌 (有效期 60 分钟，适用于快速测试，获取方式参考仓库README)。
    • 'BOX_JWT_BASE64': Base64 编码的 JWT 配置 (推荐，用于持久连接，获取和配置方式参考仓库README)。
    • 'BOX_USER_ID': Box 用户 ID (使用 JWT 认证时需要，通常为您的 Box 企业ID或开发者账户的用户ID)。

认证方式选择:

  • 开发者令牌 (BOX_DEV_TOKEN): 简单易用，但有效期短，仅用于测试。
  • JWT (JSON Web Token, BOX_JWT_BASE64, BOX_USER_ID): 安全性更高，支持持久连接，推荐用于生产环境。 JWT 配置获取方法请参考仓库 README。

基本使用方法

  1. 启动 MCP 服务器后，在 MCP 客户端（如 Claude Desktop）中配置并连接到该服务器。
  2. 使用客户端的资源浏览功能，可以列出 Box 根目录下的文件和文件夹。
  3. 可以使用文件或文件夹的 URI 访问特定资源。文件 URI 格式为 'box://file/{fileId}'。
  4. 使用 'search' 工具，可以通过关键词搜索 Box 中的文件。
  5. 使用 'read' 工具，可以通过文件 URI 读取文件内容。

信息

分类

数据库与文件

访问项目