AI导哈

MCP服务器工具集

Box提供的多功能内容管理平台服务器工具集，支持文件管理、协作、搜索等操作。

  • by box-community
  • Python
  • 本地部署
  • 101 星标
  • 更新于
在 GitHub 查看 box-community/mcp-server-box

使用说明

Box MCP服务器

[！警告] 此存储库已停止使用，不再维护。 Box现在提供了一个官方支持的托管MCP服务器，具有最佳体验和完整功能。 请迁移到托管的MCP服务器： 设置Box MCP服务器→

快速开始

克隆存储库：

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

可选但推荐 uv 虚拟环境和依赖关系管理的安装：

自制（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

设置环境变量：

在中为Box身份验证设置以下环境变量 .env 文件或您的系统环境。

有关全面的身份验证配置选项，请参阅 身份验证指南.

在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

备注:

  • 这 BOX_MCP_SERVER_AUTH_TOKEN 用于在使用时向MCP服务器验证MCP客户端 --mcp-auth-type=token （独立于Box身份验证）

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

uv run src/mcp_server_box.py

Box社区MCP服务器工具

以下是可用工具的摘要：

可用工具 说明
box_tools_ai 基于AI的文件和中心查询
box_tools协作 管理文件/文件夹协作
box_tools_docgen 文档生成和模板管理
box_tools文件 文件操作（读取、上传、下载）
box_tools文件夹 文件夹操作（列表、创建、删除、更新）
box_tools_generic 通用Box API实用程序
box_tools_groups 组管理和查询
box_tools元数据 元数据模板和实例管理
box_tools_search 搜索文件和文件夹
box_tools_shared_links 文件/文件夹/网络链接的共享链接管理
box_tools任务 任务和任务分配管理
box_tools_users 用户管理和查询
box_tools_web_link Web链接创建和管理

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

添加配置：

{
    "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

  1. 转到克劳德->设置->连接器
  2. 选择 Add custom connector
  3. 配置：
    1. 给它起个名字
    2. 输入URL，例如。 https://mcp.myserver.com/mcp
    3. 可选择输入 client id 和 client secret
  4. 点击添加
  5. 单击连接。OAuth流应该开始。完成流程
  6. 回到Claude，单击配置。你应该看到所有可用的工具。

相关 MCP