Box

Box MCP Server

[!WARNING] ที่เก็บนี้ถูกยกเลิกและไม่มีการดูแลรักษาอีกต่อไป ตอนนี้ Box มีเซิร์ฟเวอร์ MCP แบบโฮสต์ที่รองรับอย่างเป็นทางการ ซึ่งมอบประสบการณ์ที่ดีที่สุดและฟังก์ชันการทำงานเต็มรูปแบบ โปรดย้ายไปยังเซิร์ฟเวอร์ MCP แบบโฮสต์: ตั้งค่า Box MCP Server →

เริ่มต้นอย่างรวดเร็ว

โคลนที่เก็บ:

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

ตั้งค่าตัวแปรสภาพแวดล้อม:

ตั้งค่าตัวแปรสภาพแวดล้อมต่อไปนี้สำหรับการตรวจสอบสิทธิ์ Box ในไฟล์ .env หรือสภาพแวดล้อมระบบของคุณ

สำหรับตัวเลือกการกำหนดค่าการตรวจสอบสิทธิ์ที่ครอบคลุม โปรดดู คู่มือการตรวจสอบสิทธิ์

การใช้ OAuth2.0 กับ Box App

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)

รันเซิร์ฟเวอร์ MCP ในโหมด STDIO:

uv run src/mcp_server_box.py

เครื่องมือ Box Community MCP Server

ด้านล่างนี้คือสรุปเครื่องมือที่พร้อมใช้งาน:

เครื่องมือที่พร้อมใช้งาน	คำอธิบาย
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 Community MCP Server

พารามิเตอร์อินเทอร์เฟซบรรทัดคำสั่ง

ในการรันเซิร์ฟเวอร์ 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 Desktop

โหมด 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

1. ไปที่ Claude -> Settings -> Connectors
2. เลือก Add custom connector
3. การกำหนดค่า:
   1. ตั้งชื่อให้มัน
   2. ป้อน URL เช่น https://mcp.myserver.com/mcp
   3. ป้อน client id และ client secret (ทางเลือก)
4. คลิก add
5. คลิก connect ขั้นตอน OAuth ควรเริ่มต้นขึ้น ทำตามขั้นตอนให้เสร็จ
6. กลับไปที่ Claude คลิก Configure คุณควรเห็นเครื่องมือทั้งหมดที่พร้อมใช้งาน