butterstack-mcp

Сервер Model Context Protocol (MCP) для ButterStack: предоставьте AI-ассистенту доступ на чтение и запись к вашему конвейеру разработки игр, задачам, сборкам и утверждению ассетов.

Ноль зависимостей во время выполнения. Только встроенные модули Node.

Установка

Добавьте это в конфигурацию вашего MCP-клиента. Глобальная установка не требуется, npx загружает его по запросу:

{
  "mcpServers": {
    "butterstack": {
      "command": "npx",
      "args": ["-y", "butterstack-mcp"]
    }
  }
}

Claude Desktop

Отредактируйте claude_desktop_config.json (Настройки -> Разработчик -> Изменить конфигурацию) и добавьте блок выше в раздел mcpServers, затем перезапустите Claude Desktop.

Cursor

Добавьте тот же блок в .cursor/mcp.json в вашем проекте или в глобальные настройки Cursor MCP, в раздел mcpServers.

Antigravity

Добавьте тот же блок в конфигурацию MCP Antigravity в раздел mcpServers.

Related MCP server: Workel MCP Server

Аутентификация

Установите BUTTERSTACK_API_TOKEN в переменные окружения MCP-сервера вашего клиента. Это основной и рекомендуемый способ аутентификации: он работает автономно, без установки чего-либо ещё.

{
  "mcpServers": {
    "butterstack": {
      "command": "npx",
      "args": ["-y", "butterstack-mcp"],
      "env": {
        "BUTTERSTACK_API_TOKEN": "your-token-here"
      }
    }
  }
}

Сгенерируйте токен в настройках вашей учётной записи ButterStack.

Если у вас отдельно установлен ButterStack CLI и вы уже выполнили butter auth login, этот сервер также подхватит учётные данные, сохранённые им на диске (~/.config/butterstack/credentials.json), так что вам не придётся настраивать токен дважды. Но CLI не является зависимостью этого пакета, и его установка не требуется: одного BUTTERSTACK_API_TOKEN достаточно.

Хост

По умолчанию сервер обращается к https://www.butterstack.com. Чтобы указать на самостоятельный или локальный экземпляр, задайте BUTTERSTACK_HOST:

{
  "env": {
    "BUTTERSTACK_API_TOKEN": "your-token-here",
    "BUTTERSTACK_HOST": "http://localhost:3000"
  }
}

Сервер отказывается отправлять сохранённые учётные данные на хост, отличный от того, для которого они были выпущены. Если вы видите ошибку "Refusing to send the stored credential", либо задайте BUTTERSTACK_HOST так, чтобы он совпадал с хостом, для которого были выпущены ваши учётные данные, либо сгенерируйте новые учётные данные для хоста, на который вы указываете.

Инструменты

Каждый инструмент принимает project_id (кроме projects_list), который может быть либо числовым идентификатором проекта, либо его именем.

Промпты

Ресурсы

Требования

Node 18 или новее. Это политика поддерживаемых версий, а не жёсткий технический минимум: сервер использует только встроенные модули, совместимые вплоть до Node 10.9.0, но 18 — это самая старая версия, на которой пакет реально протестирован.

Лицензия

MIT