heroku-mcp-сервер

👁 значок кузнеца

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

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

👁 Развертывать

Related MCP server: Algolia

Обзор

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>"
 }
 }
 }
 }
}

Курсор

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

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

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

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

Явная форма:

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

Виндсерфинг

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

{
 "mcpServers": {
 "heroku": {
 "command": "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 .

1. Свяжите проект как глобальный CLI, используя npm link из корня проекта.

2. Выполните сборку с помощью 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 с полнофункциональными точками останова в коде:

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 :

npx -y @smithery/cli install @heroku/heroku-mcp-server --client claude

Maintenance

Resources

• NPM Package
• GitHub Repository
Need Help?
• Reddit Discussion
Related Servers

Tools

• create_addonA
• create_appA
• deploy_to_herokuA
• get_addon_infoA
• get_app_infoA
• get_app_logsA
• list_addon_plansA
• list_addonsA