Box

официальный

Взаимодействуйте с платформой Intelligent Content Management через Box AI.

GitHub

102

Что можно делать с Box MCP?

Поиск файлов и папок — Поиск содержимого в Box с помощью box_tools_search по ключевому слову, типу файла или метаданным.
Просмотр, создание или управление папками — Просмотр содержимого папок, создание новых папок, обновление и удаление существующих с помощью box_tools_folders.
Чтение, загрузка или скачивание файлов — Получение содержимого файлов, загрузка новых версий или скачивание файлов через box_tools_files.
Управление общими ссылками — Создание, обновление или удаление общих ссылок для файлов, папок и веб-ссылок с помощью box_tools_shared_links.
Запросы к файлам с помощью ИИ — Задавайте вопросы о содержимом файлов или данных хаба через box_tools_ai.
Работа с шаблонами метаданных — Создание и управление шаблонами метаданных, а также применение значений экземпляров к файлам с помощью box_tools_metadata.

Документация

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 или в системном окружении.

Для получения подробной информации о параметрах конфигурации аутентификации см. Руководство по аутентификации.

Использование 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

Инструменты Box Community MCP Server

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

Доступные инструменты	Описание
box_tools_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

Перейдите в Claude -> Настройки -> Коннекторы
Выберите Add custom connector
Конфигурации:
1. Дайте ему имя
2. Введите URL, например https://mcp.myserver.com/mcp
3. При необходимости введите client id и client secret
Нажмите «Добавить»
Нажмите «Подключить». Должен запуститься поток OAuth. Завершите поток
Вернувшись в Claude, нажмите «Настроить». Вы должны увидеть все доступные инструменты.

Box