Servidor MCP de Box

[!WARNING] Este repositorio está discontinuado y ya no recibe mantenimiento. Box ahora ofrece un servidor MCP alojado con soporte oficial que brinda la mejor experiencia y funcionalidad completa. Por favor, migre al servidor MCP alojado: Configurar el servidor MCP de Box →

Inicio rápido

Clone el repositorio:

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

Instalación opcional pero recomendada de uv para el entorno virtual y la gestión de dependencias:

Homebrew (macOS)

brew install uv

WinGet (Windows)

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

En macOS y Linux

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

En Windows

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

Configure el entorno virtual e instale las dependencias:

uv sync

Establezca las variables de entorno:

Establezca las siguientes variables de entorno para la autenticación de Box en un archivo .env o en el entorno de su sistema.

Para conocer las opciones completas de configuración de autenticación, consulte la Guía de autenticación.

Uso de OAuth2.0 con una aplicación de 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

Nota:

• El BOX_MCP_SERVER_AUTH_TOKEN se utiliza para autenticar al cliente MCP ante el servidor MCP cuando se usa --mcp-auth-type=token (independientemente de la autenticación de Box)

Ejecute el servidor MCP en modo STDIO:

uv run src/mcp_server_box.py

Related MCP server: Alfresco MCP Server

Herramientas del servidor MCP de la comunidad de Box

A continuación se muestra un resumen de las herramientas disponibles:

Detalles de las operaciones del servidor MCP de la comunidad de Box

Parámetros de la interfaz de línea de comandos

Para ejecutar el servidor MCP con configuraciones específicas, puede utilizar los siguientes parámetros de línea de comandos:

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)

Para obtener información detallada sobre los tipos de autenticación, configuraciones y casos de uso, consulte la Guía de autenticación.

Configuración de Claude Desktop

Modo STDIO

Edite su claude_desktop_config.json:

code ~/Library/Application Support/Claude/claude_desktop_config.json

Añada la configuración:

{
    "mcpServers": {
        "mcp-server-box": {
            "command": "uv",
            "args": [
                "--directory",
                "/path/to/mcp-server-box",
                "run",
                "src/mcp_server_box.py"
            ]
        }
    }
}

Reinicie Claude si se está ejecutando.

Modo HTTP

Asumiendo que su servidor MCP se está ejecutando en https://mcp.myserver.com/mcp

1. Vaya a Claude -> Ajustes -> Conectores

2. Seleccione Añadir conector personalizado

3. Configuraciones:

   1. Asígnele un nombre

   2. Introduzca la URL, p. ej., https://mcp.myserver.com/mcp

   3. Opcionalmente, introduzca el client id y el client secret

4. Haga clic en añadir

5. Haga clic en conectar. El flujo de OAuth debería iniciarse. Complete el flujo

6. De vuelta en Claude, haga clic en Configurar. Debería ver todas las herramientas disponibles.