Box

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

पर्यावरण चर सेट करें:

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-auth-type=token का उपयोग करते समय MCP क्लाइंट को MCP सर्वर से प्रमाणीकृत करने के लिए किया जाता है (Box प्रमाणीकरण से स्वतंत्र)

MCP सर्वर को STDIO मोड में चलाएँ:

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 पर चल रहा है

1. Claude -> सेटिंग्स -> कनेक्टर्स पर जाएँ
2. Add custom connector चुनें
3. कॉन्फ़िगरेशन:
   1. इसे एक नाम दें
   2. URL दर्ज करें जैसे https://mcp.myserver.com/mcp
   3. वैकल्पिक रूप से client id और client secret दर्ज करें
4. जोड़ें पर क्लिक करें
5. कनेक्ट पर क्लिक करें। OAuth प्रवाह शुरू होना चाहिए। प्रवाह पूरा करें
6. Claude में वापस, कॉन्फ़िगर करें पर क्लिक करें। आपको सभी उपलब्ध उपकरण दिखाई देने चाहिए।