Box

Box MCP Server

[!WARNING] Dieses Repository wird nicht mehr weitergeführt und nicht mehr gewartet. Box bietet jetzt einen offiziell unterstützten, gehosteten MCP-Server mit der besten Erfahrung und vollem Funktionsumfang. Bitte migrieren Sie zum gehosteten MCP-Server: Box MCP Server einrichten →

Schnellstart

Repository klonen:

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

Optional, aber empfohlen: uv-Installation für virtuelle Umgebungen und Abhängigkeitsverwaltung:

Homebrew (macOS)

brew install uv

WinGet (Windows)

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

Auf macOS und Linux

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

Auf Windows

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

Virtuelle Umgebung einrichten und Abhängigkeiten installieren:

uv sync

Umgebungsvariablen setzen:

Setzen Sie die folgenden Umgebungsvariablen für die Box-Authentifizierung in einer .env-Datei oder Ihrer Systemumgebung.

Umfassende Konfigurationsoptionen für die Authentifizierung finden Sie im Authentifizierungsleitfaden.

OAuth2.0 mit einer Box-App verwenden

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

Hinweis:

• Der BOX_MCP_SERVER_AUTH_TOKEN wird verwendet, um den MCP-Client gegenüber dem MCP-Server zu authentifizieren, wenn --mcp-auth-type=token verwendet wird (unabhängig von der Box-Authentifizierung)

MCP-Server im STDIO-Modus ausführen:

uv run src/mcp_server_box.py

Box Community MCP Server Tools

Nachfolgend eine Übersicht der verfügbaren Tools:

Verfügbare Tools	Beschreibung
box_tools_ai	KI-gestützte Datei- und Hub-Abfragen
box_tools_collaboration	Datei-/Ordner-Kollaborationen verwalten
box_tools_docgen	Dokumentenerstellung und Vorlagenverwaltung
box_tools_files	Dateioperationen (Lesen, Hochladen, Herunterladen)
box_tools_folders	Ordneroperationen (Auflisten, Erstellen, Löschen, Aktualisieren)
box_tools_generic	Allgemeine Box-API-Dienstprogramme
box_tools_groups	Gruppenverwaltung und -abfragen
box_tools_metadata	Metadatenvorlagen- und Instanzverwaltung
box_tools_search	Dateien und Ordner durchsuchen
box_tools_shared_links	Freigabelink-Verwaltung für Dateien/Ordner/Weblinks
box_tools_tasks	Aufgaben- und Aufgabenzuweisungsverwaltung
box_tools_users	Benutzerverwaltung und -abfragen
box_tools_web_link	Weblink-Erstellung und -Verwaltung

Details zu den Operationen des Box Community MCP Servers

Befehlszeilenparameter

Um den MCP-Server mit bestimmten Konfigurationen auszuführen, können Sie die folgenden Befehlszeilenparameter verwenden:

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)

Detaillierte Informationen zu Authentifizierungstypen, Konfigurationen und Anwendungsfällen finden Sie im Authentifizierungsleitfaden.

Claude Desktop-Konfiguration

STDIO-Modus

Bearbeiten Sie Ihre 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"
            ]
        }
    }
}

Starten Sie Claude neu, falls es ausgeführt wird.

HTTP-Modus

Angenommen, Ihr MCP-Server läuft auf https://mcp.myserver.com/mcp

1. Gehen Sie zu Claude -> Einstellungen -> Konnektoren
2. Wählen Sie Add custom connector
3. Konfigurationen:
   1. Geben Sie einen Namen ein
   2. Geben Sie die URL ein, z. B. https://mcp.myserver.com/mcp
   3. Geben Sie optional den client id und den client secret ein
4. Klicken Sie auf Hinzufügen
5. Klicken Sie auf Verbinden. Der OAuth-Flow sollte starten. Schließen Sie den Flow ab
6. Zurück in Claude klicken Sie auf Konfigurieren. Sie sollten alle verfügbaren Tools sehen.