Heroku MCP server

heroku-mcp-сервер

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

Развертывание на Heroku

Обзор

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 :

Зед

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

Курсор

Примечание: работают как простая, так и явная формы, но для максимальной совместимости с инструментами агента ключ должен быть "heroku" (а не "heroku-mcp-server" ).

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

Простая форма:

Явная форма:

Виндсерфинг

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

Клайн

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

VSCode

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

Трей

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

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

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

• 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 .

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

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

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

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

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

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

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

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

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

1. Сохраните свой токен аутентификации Heroku в настройках пользователя VS Code:
   • Откройте палитру команд (Cmd/Ctrl + Shift + P).
   • Preferences: Open User Settings (JSON) .
   • Добавьте следующий фрагмент:
   { "heroku.mcp.authToken": "your-token-here" }
2. Создайте или обновите .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"] } ] }
3. Создайте .vscode/tasks.json :
   { "version": "2.0.0", "tasks": [ { "type": "npm", "script": "build:watch", "group": { "kind": "build", "isDefault": true }, "problemMatcher": ["$tsc"] } ] }
4. (Необязательно) Установите точки останова в файлах TypeScript.
5. Нажмите F5 или используйте боковую панель Run and Debug .

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

Установка через Smithery

Чтобы автоматически установить Heroku Platform MCP Server для Claude Desktop через Smithery :