mcp/box

Box MCP Server

镜像概述和主要用途

Box MCP Server 是一个能够与 Box API 交互的 MCP 服务器。MCP (Model Context Protocol) 是一种用于简化 AI 应用构建的协议，允许 AI 模型通过标准化接口与外部工具和服务交互。

什么是 MCP 服务器？

核心功能和特性

• 通过标准化 MCP 接口与 Box API 交互
• 提供多种工具用于文件管理、内容提取和 AI 分析
• 支持文件上传、下载、搜索和文件夹管理
• 集成 Box AI 功能，可基于文件内容进行智能问答和数据分析
• 轻量级 Docker 部署，易于集成到现有系统

镜像信息

提供的工具 (12种)

使用场景和适用范围

• 需要与 Box 云存储集成的 AI 应用程序
• 基于 Box 中存储的文档构建智能问答系统
• 需要自动化 Box 文件管理的工作流
• 构建基于 Box 内容的数据分析工具
• 开发需要访问 Box 数据的 AI 助手

部署和使用方法

环境变量

Docker 运行命令

bash
docker run -i --rm \
  -e BOX_CLIENT_ID="your_client_id" \
  -e BOX_CLIENT_SECRET="your_client_secret" \
  mcp/box

Docker Compose 配置

yaml
version: '3'
services:
  box-mcp-server:
    image: mcp/box
    environment:
      - BOX_CLIENT_ID=your_client_id
      - BOX_CLIENT_SECRET=your_client_secret
    restart: unless-stopped

MCP 服务器配置示例

json
{
  "mcpServers": {
    "box": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "BOX_CLIENT_ID",
        "-e",
        "BOX_CLIENT_SECRET",
        "mcp/box"
      ],
      "env": {
        "BOX_CLIENT_ID": "your_client_id",
        "BOX_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

工具详情

box_ai_extract_data

使用 AI 从 Box 中的单个文件提取数据。

box_ask_ai_tool

向 Box AI 询问有关 Box 中文件的问题。

box_ask_ai_tool_multi_file

使用 Box AI 基于多个文件的内容分析并响应提示。

此工具允许用户使用特定提示查询 Box AI，利用存储在 Box 中的多个文件内容。AI 处理这些文件并基于提供的提示生成响应。

box_authorize_app_tool

授权 Box 应用程序。

启动 Box 应用授权流程。

返回: string - 授权消息

box_download_file_tool

从 Box 下载文件并将其内容作为字符串返回。

支持文本文件（直接返回内容）和图像（返回 base64 编码）。其他文件类型将返回错误消息。可选地将文件保存到本地。

box_list_folder_content_by_folder_id

通过文件夹 ID 列出 Box 中文件夹的内容。

box_manage_folder_tool

管理 Box 文件夹 - 创建、删除或更新。

box_read_tool

读取 Box 中文件的文本内容。

box_search_folder_by_name

通过名称查找 Box 中的文件夹。

box_search_tool

使用给定查询在 Box 中搜索文件。

box_upload_file_tool

将内容作为文件上传到 Box。

box_who_am_i

获取当前用户的信息。

此工具也可用于检查连接状态。

返回: string - 当前用户信息

安全性

镜像签名验证

可以使用以下命令验证镜像签名：

bash
COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/box --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub

为什么使用 Docker 运行 MCP 服务器更安全？

为什么使用 Docker 运行 MCP 服务器更安全？