Heroku MCP server

Heroku-MCP-Server

Der MCP-Server der Heroku-Plattform funktioniert mit Common Runtime, Cedar Private und Shield Spaces sowie Fir Private Spaces.

Bereitstellung auf Heroku

Überblick

Der Heroku Platform MCP Server ist eine spezialisierte Implementierung des Model Context Protocol (MCP), die die nahtlose Interaktion zwischen großen Sprachmodellen (LLMs) und der Heroku-Plattform ermöglicht. Dieser Server bietet umfangreiche Tools und Funktionen, mit denen LLMs Ressourcen der Heroku-Plattform lesen, verwalten und bedienen können.

Hauptmerkmale:

• Direkte Interaktion mit Ressourcen der Heroku-Plattform durch LLM-gesteuerte Tools
• Sicherer und authentifizierter Zugriff auf die APIs der Heroku-Plattform unter Nutzung der Heroku-CLI
• Natürliche Sprachschnittstelle für Interaktionen auf der Heroku-Plattform

Hinweis: Der Heroku Platform MCP Server befindet sich derzeit in der frühen Entwicklungsphase. Da wir die Implementierung kontinuierlich verbessern und verfeinern, können sich die verfügbaren Funktionen und Tools weiterentwickeln. Wir freuen uns über Feedback und Beiträge, um die Zukunft dieses Projekts mitzugestalten.

Authentifizierung

Generieren Sie mit einer der folgenden Methoden ein Heroku-Autorisierungstoken:

• Verwenden Sie den Heroku CLI-Befehl:
  heroku authorizations:create
• Verwenden eines vorhandenen Tokens in der CLI
  heroku auth:token
  Kopieren Sie das Token und verwenden Sie es in den folgenden Schritten als Ihren HEROKU_API_KEY .
• In Ihrem Heroku-Dashboard :
  1. Wählen Sie Ihren Avatar und dann „Kontoeinstellungen“ aus.
  2. Öffnen Sie die Registerkarte „Anwendungen“.
  3. Klicken Sie neben „Autorisierungen “ auf „Autorisierung erstellen“ .

Konfigurieren des Heroku Platform MCP-Servers

Sie können Claude Desktop, Zed, Cursor, Windsurf und andere so konfigurieren, dass sie mit dem Heroku Platform MCP Server funktionieren.

Claude Desktop

Fügen Sie diesen Codeausschnitt zu Ihrer claude_desktop_config.json hinzu:

Zed

Fügen Sie diesen Codeausschnitt zu Ihrer Zed-Datei „ settings.json “ hinzu:

Cursor

Hinweis: Sowohl die einfache als auch die explizite Form funktionieren, aber für maximale Kompatibilität mit Agent-Tools sollte der Schlüssel "heroku" (nicht "heroku-mcp-server" ) sein.

Fügen Sie diesen Codeausschnitt zu Ihrem Cursor mcp.json hinzu:

Einfache Form:

Explizite Form:

Windsurf

Fügen Sie diesen Codeausschnitt zu Ihrer Windsurf mcp_config.json hinzu:

Cline

Fügen Sie diesen Codeausschnitt zu Ihrer Cline- config.json hinzu:

VSCode

Fügen Sie diesen Snippet zu Ihrer VSCode- settings.json oder .vscode/mcp.json hinzu:

Trae

Fügen Sie diesen Snippet zu Ihrem Trae mcp_settings.json hinzu:

Verfügbare Tools

Anwendungsmanagement

• list_apps – Listet alle Heroku-Apps auf. Sie können Apps nach persönlichen, Mitarbeiter-, Team- oder Bereichs-Apps filtern.
• get_app_info – Erhalten Sie detaillierte Informationen zu einer App, einschließlich ihrer Konfiguration, Dynos und Add-Ons.
• create_app – Erstellen Sie eine neue App mit anpassbaren Einstellungen für Region, Team und Bereich.
• rename_app – Benennen Sie eine vorhandene App um.
• transfer_app – Übertragen Sie den Besitz einer App auf einen anderen Benutzer oder ein anderes Team.
• deploy_to_heroku – Stellen Sie Projekte mit einer app.json Konfiguration auf Heroku bereit und unterstützen Sie Teambereitstellungen, private Bereiche und Umgebungs-Setups.
• deploy_one_off_dyno – Führen Sie Code oder Befehle in einer Sandbox-Umgebung auf einem Heroku One-Off-Dyno aus. Unterstützt Dateierstellung, Netzwerkzugriff, Umgebungsvariablen und automatische Bereinigung. Ideal für die Ausführung von Skripten, Tests oder temporären Workloads.

Prozess- und Prüfstandsmanagement

• ps_list – Listet alle Dynos für eine App auf.
• ps_scale – Skalieren Sie die Anzahl der Dynos nach oben oder unten oder ändern Sie die Größe der Dynos.
• ps_restart – Starten Sie bestimmte Dynos, Prozesstypen oder alle Dynos neu.

Add-ons

• list_addons – Listet alle Add-Ons für alle Apps oder für eine bestimmte App auf.
• get_addon_info – Erhalten Sie detaillierte Informationen zu einem bestimmten Add-on.
• create_addon – Stellen Sie ein neues Add-on für eine App bereit.

Wartung und Protokolle

• maintenance_on – Wartungsmodus für eine App aktivieren.
• maintenance_off – Deaktivieren Sie den Wartungsmodus für eine App.
• get_app_logs – Anwendungsprotokolle anzeigen.

Pipeline-Management

• pipelines_create – Erstellen Sie eine neue Pipeline.
• pipelines_promote – Apps in die nächste Phase einer Pipeline befördern.
• pipelines_list – Listet verfügbare Pipelines auf.
• pipelines_info – Erhalten Sie detaillierte Pipeline-Informationen.

Team- und Raummanagement

• list_teams – Listet die Teams auf, denen Sie angehören.
• list_private_spaces – Listet verfügbare Plätze auf.

PostgreSQL-Datenbankverwaltung

• pg_psql – Führen Sie SQL-Abfragen für die Heroku PostgreSQL-Datenbank aus.
• pg_info – Zeigt detaillierte Datenbankinformationen an.
• pg_ps – Aktive Abfragen und Ausführungsdetails anzeigen.
• pg_locks – Datenbanksperren anzeigen und blockierende Transaktionen identifizieren.
• pg_outliers – Identifizieren Sie ressourcenintensive Abfragen.
• pg_credentials – Datenbankanmeldeinformationen und Zugriff verwalten.
• pg_kill – Beenden Sie bestimmte Datenbankprozesse.
• pg_maintenance – Zeigt Informationen zur Datenbankwartung an.
• pg_backups – Verwalten Sie Datenbanksicherungen und -pläne.
• pg_upgrade – Aktualisieren Sie PostgreSQL auf eine neuere Version.

Debuggen

Sie können den MCP-Inspektor oder die VS Code-Funktion „Ausführen und Debuggen“ verwenden, um den Server auszuführen und zu debuggen.

1. Verknüpfen Sie das Projekt als globale CLI mithilfe npm link vom Projektstamm aus.
2. Erstellen Sie mit npm run build:dev oder achten Sie auf Dateiänderungen und erstellen Sie automatisch mit npm run build:watch .

Verwenden Sie den MCP-Inspektor

Verwenden Sie den MCP-Inspektor ohne Haltepunkte im Code:

Alternativ, wenn Sie das Paket in einem bestimmten Verzeichnis installiert haben oder aktiv auf dem Heroku MCP-Server entwickeln:

Verwenden Sie die VS Code-Ausführen- und Debug-Funktion

Verwenden Sie den VS Code Run and Debug-Launcher mit voll funktionsfähigen Haltepunkten im Code:

1. Suchen und wählen Sie „Debug ausführen“.
2. Wählen Sie im Dropdown-Menü die Konfiguration mit der Bezeichnung „ MCP Server Launcher “ aus.
3. Wählen Sie die Schaltfläche „Ausführen/Debuggen“ aus.

VS Code / Cursor-Debugging-Setup

So richten Sie lokales Debuggen mit Haltepunkten ein:

1. Speichern Sie Ihr Heroku-Authentifizierungstoken in den VS Code-Benutzereinstellungen:
   • Öffnen Sie die Befehlspalette (Cmd/Strg + Umschalt + P).
   • Geben Sie Preferences: Open User Settings (JSON) ein.
   • Fügen Sie den folgenden Codeausschnitt hinzu:
   { "heroku.mcp.authToken": "your-token-here" }
2. Erstellen oder aktualisieren Sie .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. Erstellen Sie .vscode/tasks.json :
   { "version": "2.0.0", "tasks": [ { "type": "npm", "script": "build:watch", "group": { "kind": "build", "isDefault": true }, "problemMatcher": ["$tsc"] } ] }
4. (Optional) Legen Sie Haltepunkte in Ihren TypeScript-Dateien fest.
5. Drücken Sie F5 oder verwenden Sie die Seitenleiste Run and Debug .

Hinweis: Der Debugger erstellt Ihre TypeScript-Dateien vor dem Start automatisch.

Installation über Smithery

So installieren Sie den Heroku Platform MCP Server für Claude Desktop automatisch über Smithery :