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社区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. 给它起个名字 1. 输入URL，例如。 https://mcp.myserver.com/mcp 1. 可选择输入 client id 和 client secret

1. 点击添加
2. 单击连接。OAuth流应该开始。完成流程
3. 回到Claude，单击配置。你应该看到所有可用的工具。