MCP-сервер Box

[!WARNING] Этот репозиторий больше не поддерживается. Box теперь предоставляет официально поддерживаемый хостинговый MCP-сервер с наилучшим пользовательским опытом и полной функциональностью. Пожалуйста, перейдите на хостинговый MCP-сервер: Настройка MCP-сервера Box →

Быстрый старт

Клонируйте репозиторий:

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

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

Related MCP server: Alfresco MCP Server

Инструменты сообщества MCP-сервера Box

Ниже приведено краткое описание доступных инструментов:

Подробности операций сообщества MCP-сервера Box

Параметры интерфейса командной строки

Для запуска 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

Добавьте конфигурацию:

{
    "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. Вы должны увидеть все доступные инструменты.