MCP-сервер Heroku

heroku-mcp-сервер

MCP-сервер Heroku Platform работает в Common Runtime, Cedar Private и Shield Spaces, а также Fir Private Spaces.

Обзор

Heroku Platform MCP Server — это специализированная реализация Model Context Protocol (MCP), разработанная для обеспечения бесперебойного взаимодействия между большими языковыми моделями (LLM) и платформой Heroku. Этот сервер предоставляет надежный набор инструментов и возможностей, которые позволяют LLM читать, управлять и работать с ресурсами платформы Heroku.

Основные характеристики:

Прямое взаимодействие с ресурсами платформы Heroku через инструменты на основе LLM
Безопасный и аутентифицированный доступ к API-интерфейсам платформы Heroku с использованием Heroku CLI
Интерфейс на естественном языке для взаимодействия с платформой Heroku

Примечание: MCP-сервер Heroku Platform в настоящее время находится на ранней стадии разработки. Поскольку мы продолжаем улучшать и совершенствовать реализацию, доступные функции и инструменты могут развиваться. Мы приветствуем отзывы и вклады, которые помогут сформировать будущее этого проекта.

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

Сгенерируйте токен авторизации Heroku одним из следующих способов:

Используйте команду CLI Heroku:
heroku authorizations:create
Использовать существующий токен в CLI
heroku auth:token
Скопируйте токен и используйте его в качестве HEROKU_API_KEY в следующих шагах.
На панели инструментов Heroku :
1. Выберите свой аватар, затем выберите «Настройки учетной записи» .
2. Откройте вкладку «Приложения».
3. Рядом с разделом «Авторизации» нажмите «Создать авторизацию» .

Настройте сервер MCP платформы Heroku

Вы можете настроить Claude Desktop, Zed, Cursor, Windsurf и другие для работы с MCP-сервером Heroku Platform.

Клод Десктоп

Добавьте этот фрагмент в ваш claude_desktop_config.json :

{
  "mcpServers": {
    "heroku": {
      "command": "npx",
      "args": ["-y", "@heroku/mcp-server"],
      "env": {
        "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>"
      }
    }
  }
}

Зед

Добавьте этот фрагмент в ваш Zed settings.json :

{
  "context_servers": {
    "heroku": {
      "command": {
        "path": "npx",
        "args": ["-y", "@heroku/mcp-server"]
      },
      "env": {
        "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>"
      }
    }
  }
}

Курсор

Добавьте этот фрагмент в ваш Cursor mcp.json :

{
  "mcpServers": {
    "heroku": {
      "command": {
        "path": "npx",
        "args": ["-y", "@heroku/mcp-server"]
      },
      "env": {
        "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>"
      }
    }
  }
}

Виндсерфинг

Добавьте этот фрагмент в ваш Windsurf mcp_config.json :

{
  "mcpServers": {
    "heroku": {
      "command": {
        "path": "npx",
        "args": ["-y", "@heroku/mcp-server"]
      },
      "env": {
        "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>"
      }
    }
  }
}

Клайн

Добавьте этот фрагмент в ваш Cline config.json :

{
  "mcpServers": {
    "heroku": {
      "command": "npx",
      "args": ["-y", "@heroku/mcp-server"],
      "env": {
        "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>"
      }
    }
  }
}

VSCode

Добавьте этот фрагмент в settings.json или .vscode/mcp.json вашего VSCode:

{
  "mcp": {
    "servers": {
      "heroku": {
        "type": "stdio",
        "command": "npx",
        "args": ["-y", "@heroku/mcp-server"],
        "env": {
          "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>"
        }
      }
    }
  }
}

Трей

Добавьте этот фрагмент в ваш Trae mcp_settings.json :

{
  "mcpServers": {
    "heroku": {
      "command": "npx",
      "args": ["-y", "@heroku/mcp-server"],
      "env": {
        "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>"
      }
    }
  }
}

Доступные инструменты

Управление приложениями

list_apps - Список всех приложений Heroku. Вы можете фильтровать приложения по личным, совместным, командным или пространственным параметрам.
get_app_info — получение подробной информации о приложении, включая его конфигурацию, динамометры и надстройки.
create_app — создание нового приложения с настраиваемыми параметрами для региона, команды и пространства.
rename_app — переименовать существующее приложение.
transfer_app — передача права собственности на приложение другому пользователю или команде.
deploy_to_heroku — развертывание проектов в Heroku с конфигурацией app.json , поддерживающей командные развертывания, частные пространства и настройки среды.
deploy_one_off_dyno — выполнение кода или команд в изолированной среде на Heroku одноразовом dyno. Поддерживает создание файлов, сетевой доступ, переменные среды и автоматическую очистку. Идеально подходит для запуска скриптов, тестов или временных рабочих нагрузок.

Управление процессами и динамометрией

ps_list — список всех динамометров для приложения.
ps_scale — увеличение или уменьшение количества динамометров или изменение их размера.
ps_restart — перезапуск определенных динамометров, типов процессов или всех динамометров.

Дополнения

list_addons — список всех дополнений для всех приложений или для определенного приложения.
get_addon_info — Получить подробную информацию о конкретном дополнении.
create_addon — создание нового дополнения для приложения.

Техническое обслуживание и журналы

maintenance_on — включить режим обслуживания для приложения.
maintenance_off — отключить режим обслуживания для приложения.
get_app_logs — Просмотр журналов приложений.

Управление трубопроводом

pipelines_create — Создать новый конвейер.
pipelines_promote — перемещение приложений на следующий этап конвейера.
pipelines_list — список доступных конвейеров.
pipelines_info — Получите подробную информацию о трубопроводе.

Управление командой и пространством

list_teams — список команд, в которых вы состоите.
list_private_spaces — список доступных пространств.

Управление базами данных PostgreSQL

pg_psql — выполнение SQL-запросов к базе данных Heroku PostgreSQL.
pg_info - Отображение подробной информации о базе данных.
pg_ps — просмотр активных запросов и сведений о выполнении.
pg_locks — просмотр блокировок базы данных и выявление блокирующих транзакций.
pg_outliers — определение ресурсоемких запросов.
pg_credentials — Управление учетными данными и доступом к базе данных.
pg_kill — завершение определенных процессов базы данных.
pg_maintenance — Показать информацию об обслуживании базы данных.
pg_backups — Управление резервным копированием баз данных и расписаниями.
pg_upgrade — обновление PostgreSQL до более новой версии.

Отладка

Для запуска и отладки сервера можно использовать инспектор MCP или функцию запуска и отладки VS Code .

Свяжите проект как глобальный CLI, используя npm link из корня проекта.
Выполните сборку с помощью npm run build:dev или отслеживайте изменения файлов и выполняйте автоматическую сборку с помощью npm run build:watch .

Используйте MCP Inspector

Используйте инспектор MCP без точек останова в коде:

# Breakpoints are not available
npx @modelcontextprotocol/inspector heroku-mcp-server

Либо, если вы установили пакет в определенный каталог или ведете активную разработку на сервере Heroku MCP:

cd /path/to/servers
npx @modelcontextprotocol/inspector dist/index.js

Используйте функцию запуска и отладки VS Code

Используйте средство запуска и отладки VS Code с полнофункциональными точками останова в коде:

Найдите и выберите команду run debug.
В раскрывающемся списке выберите конфигурацию с надписью « MCP Server Launcher ».
Нажмите кнопку «Запустить/Отладка».

VS Code / Настройка отладки курсора

Чтобы настроить локальную отладку с точками останова:

Сохраните свой токен аутентификации Heroku в настройках пользователя VS Code:
- Откройте палитру команд (Cmd/Ctrl + Shift + P).
- Preferences: Open User Settings (JSON) .
- Добавьте следующий фрагмент:
{ "heroku.mcp.authToken": "your-token-here" }
Создайте или обновите .vscode/launch.json :
{ "version": "0.2.0", "configurations": [ { "type": "node", "request": "launch", "name": "MCP Server Launcher", "skipFiles": ["<node_internals>/**"], "program": "${workspaceFolder}/node_modules/@modelcontextprotocol/inspector/bin/cli.js", "outFiles": ["${workspaceFolder}/**/dist/**/*.js"], "env": { "HEROKU_API_KEY": "${config:heroku.mcp.authToken}", "DEBUG": "true" }, "args": ["heroku-mcp-server"], "sourceMaps": true, "console": "integratedTerminal", "internalConsoleOptions": "neverOpen", "preLaunchTask": "npm: build:watch" }, { "type": "node", "request": "attach", "name": "Attach to Debug Hook Process", "port": 9332, "skipFiles": ["<node_internals>/**"], "sourceMaps": true, "outFiles": ["${workspaceFolder}/dist/**/*.js"] }, { "type": "node", "request": "attach", "name": "Attach to REPL Process", "port": 9333, "skipFiles": ["<node_internals>/**"], "sourceMaps": true, "outFiles": ["${workspaceFolder}/dist/**/*.js"] } ], "compounds": [ { "name": "Attach to MCP Server", "configurations": ["Attach to Debug Hook Process", "Attach to REPL Process"] } ] }
Создайте .vscode/tasks.json :
{ "version": "2.0.0", "tasks": [ { "type": "npm", "script": "build:watch", "group": { "kind": "build", "isDefault": true }, "problemMatcher": ["$tsc"] } ] }
(Необязательно) Установите точки останова в файлах TypeScript.
Нажмите F5 или используйте боковую панель Run and Debug .

Примечание: отладчик автоматически создает файлы TypeScript перед запуском.

Heroku MCP server

Integrations