heroku-mcp-сервер

Name: Heroku MCP server
Author: heroku

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

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 .

Свяжите проект как глобальный 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 перед запуском.

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

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

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

Heroku MCP server