Box

Box MCP Server

[!WARNING] Kho lưu trữ này đã ngừng phát triển và không còn được bảo trì. Box hiện cung cấp máy chủ MCP được lưu trữ chính thức với trải nghiệm tốt nhất và đầy đủ chức năng. Vui lòng chuyển sang máy chủ MCP được lưu trữ: Thiết lập Box MCP Server →

Bắt đầu nhanh

Sao chép kho lưu trữ:

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

Tùy chọn nhưng khuyến nghị cài đặt uv cho môi trường ảo và quản lý phụ thuộc:

Homebrew (macOS)

brew install uv

WinGet (Windows)

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

Trên macOS và Linux

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

Trên Windows

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

Thiết lập môi trường ảo và cài đặt các phụ thuộc:

uv sync

Đặt biến môi trường:

Đặt các biến môi trường sau để xác thực Box trong tệp .env hoặc môi trường hệ thống của bạn.

Để biết các tùy chọn cấu hình xác thực toàn diện, hãy xem Hướng dẫn Xác thực.

Sử dụng OAuth2.0 với Ứng dụng Box

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

Lưu ý:

• BOX_MCP_SERVER_AUTH_TOKEN được sử dụng để xác thực máy khách MCP với máy chủ MCP khi sử dụng --mcp-auth-type=token (độc lập với xác thực Box)

Chạy máy chủ MCP ở chế độ STDIO:

uv run src/mcp_server_box.py

Công cụ Box Community MCP Server

Dưới đây là tóm tắt các công cụ có sẵn:

Công cụ có sẵn	Mô tả
box_tools_ai	Truy vấn tệp và hub hỗ trợ bởi AI
box_tools_collaboration	Quản lý cộng tác tệp/thư mục
box_tools_docgen	Tạo tài liệu và quản lý mẫu
box_tools_files	Thao tác tệp (đọc, tải lên, tải xuống)
box_tools_folders	Thao tác thư mục (liệt kê, tạo, xóa, cập nhật)
box_tools_generic	Tiện ích API Box chung
box_tools_groups	Quản lý nhóm và truy vấn
box_tools_metadata	Quản lý mẫu và phiên bản siêu dữ liệu
box_tools_search	Tìm kiếm tệp và thư mục
box_tools_shared_links	Quản lý liên kết chia sẻ cho tệp/thư mục/liên kết web
box_tools_tasks	Quản lý nhiệm vụ và phân công nhiệm vụ
box_tools_users	Quản lý người dùng và truy vấn
box_tools_web_link	Tạo và quản lý liên kết web

Chi tiết hoạt động Box Community MCP Server

Tham số dòng lệnh

Để chạy máy chủ MCP với các cấu hình cụ thể, bạn có thể sử dụng các tham số dòng lệnh sau:

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)

Để biết thông tin chi tiết về các loại xác thực, cấu hình và trường hợp sử dụng, hãy xem Hướng dẫn Xác thực.

Cấu hình Claude Desktop

Chế độ STDIO

Chỉnh sửa claude_desktop_config.json của bạn:

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"
            ]
        }
    }
}

Khởi động lại Claude nếu nó đang chạy.

Chế độ HTTP

Giả sử máy chủ MCP của bạn đang chạy trên https://mcp.myserver.com/mcp

1. Vào Claude -> Cài đặt -> Trình kết nối
2. Chọn Add custom connector
3. Cấu hình:
   1. Đặt tên cho nó
   2. Nhập URL, ví dụ: https://mcp.myserver.com/mcp
   3. Tùy chọn nhập client id và client secret
4. Nhấp thêm
5. Nhấp kết nối. Luồng OAuth sẽ bắt đầu. Hoàn tất luồng
6. Quay lại Claude, nhấp Cấu hình. Bạn sẽ thấy tất cả các công cụ có sẵn.