Box

官方

通过Box AI与智能内容管理平台进行交互。

GitHub

102

你可以用 Box MCP 做什么？

搜索文件和文件夹 — 通过关键字、文件类型或元数据，使用 box_tools_search 在 Box 中查找内容。
列出、创建或管理文件夹 — 使用 box_tools_folders 浏览文件夹内容、创建新文件夹，或更新和删除现有文件夹。
读取、上传或下载文件 — 通过 box_tools_files 检索文件内容、上传新版本或下载文件。
管理共享链接 — 使用 box_tools_shared_links 创建、更新或删除文件、文件夹和网页链接的共享链接。
使用 AI 查询文件 — 通过 box_tools_ai 询问有关文件内容或中心数据的问题。
处理元数据模板 — 使用 box_tools_metadata 创建和管理元数据模板，并将实例值应用于文件。

文档

Box MCP 服务器

[!WARNING] 此仓库已停止维护，不再更新。 Box 现已提供官方支持的托管 MCP 服务器，可带来最佳体验和完整功能。请迁移至托管 MCP 服务器：设置 Box MCP 服务器 →

快速开始

克隆仓库：

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

可选但推荐安装 `uv`，用于虚拟环境和依赖管理：

Homebrew (macOS)

brew install uv

WinGet (Windows)

winget install --id=astral-sh.uv  -e

在 macOS 和 Linux 上

curl -LsSf https://astral.sh/uv/install.sh | sh

在 Windows 上

powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

设置虚拟环境并安装依赖：

uv sync

设置环境变量：

在 .env 文件或系统环境中设置以下 Box 认证环境变量。

有关全面的认证配置选项，请参阅认证指南。

通过 Box 应用使用 OAuth2.0

BOX_CLIENT_ID = YOUR_CLIENT_ID
BOX_CLIENT_SECRET = YOUR_CLIENT_SECRET
BOX_REDIRECT_URL = http://localhost:8000/callback

# MCP Server Authentication (for HTTP transports)
BOX_MCP_SERVER_AUTH_TOKEN = YOUR_BOX_MCP_SERVER_AUTH_TOKEN
OAUTH_PROTECTED_RESOURCES_CONFIG_FILE = .oauth-protected-resource.json

注意：

当使用 --mcp-auth-type=token 时，BOX_MCP_SERVER_AUTH_TOKEN 用于 MCP 客户端向 MCP 服务器进行认证（独立于 Box 认证）

在 STDIO 模式下运行 MCP 服务器：

uv run src/mcp_server_box.py

Box 社区 MCP 服务器工具

以下是可用工具摘要：

可用工具	描述
box_tools_ai	AI 驱动的文件和中心查询
box_tools_collaboration	管理文件/文件夹协作
box_tools_docgen	文档生成和模板管理
box_tools_files	文件操作（读取、上传、下载）
box_tools_folders	文件夹操作（列出、创建、删除、更新）
box_tools_generic	通用 Box API 工具
box_tools_groups	群组管理和查询
box_tools_metadata	元数据模板和实例管理
box_tools_search	搜索文件和文件夹
box_tools_shared_links	文件/文件夹/网页链接的共享链接管理
box_tools_tasks	任务和任务分配管理
box_tools_users	用户管理和查询
box_tools_web_link	网页链接创建和管理

Box 社区 MCP 服务器操作详情

命令行接口参数

要使用特定配置运行 MCP 服务器，可以使用以下命令行参数：

uv run src/mcp_server_box.py --help

usage: mcp_server_box.py [-h] [--transport {stdio,sse,http}] [--host HOST] [--port PORT] [--mcp-auth-type {oauth,token,none}] [--box-auth-type {oauth,ccg,jwt,mcp_client}]

Box Community MCP Server

options:
  -h, --help            show this help message and exit
  --transport {stdio,sse,http}
                        Transport type (default: stdio)
  --host HOST           Host for SSE/HTTP transport (default: localhost)
  --port PORT           Port for SSE/HTTP transport (default: 8005)
  --mcp-auth-type {oauth,token,none}
                        Authentication type for MCP server (default: token)
  --box-auth-type {oauth,ccg,jwt,mcp_client}
                        Authentication type for Box API (default: oauth)

有关认证类型、配置和用例的详细信息，请参阅认证指南。

Claude 桌面版配置

STDIO 模式

编辑您的 claude_desktop_config.json：

code ~/Library/Application\ Support/Claude/claude_desktop_config.json

Add the configuration:

{
    "mcpServers": {
        "mcp-server-box": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-server-box",
                "run",
                "src/mcp_server_box.py"
            ]
        }
    }
}

如果 Claude 正在运行，请重启。

HTTP 模式

假设您的 MCP 服务器运行在 https://mcp.myserver.com/mcp

前往 Claude -> 设置 -> 连接器
选择 Add custom connector
配置：
1. 为其命名
2. 输入 URL，例如 https://mcp.myserver.com/mcp
3. 可选输入 client id 和 client secret
点击添加
点击连接。OAuth 流程应会启动。完成流程
返回 Claude，点击配置。您应该能看到所有可用工具。

Box