servidor heroku-mcp

El servidor MCP de la plataforma Heroku funciona en Common Runtime, Cedar Private y Shield Spaces y Fir Private Spaces.

Descripción general

El Servidor MCP de la Plataforma Heroku es una implementación especializada del Protocolo de Contexto de Modelo (MCP), diseñada para facilitar la interacción fluida entre los grandes modelos de lenguaje (LLM) y la Plataforma Heroku. Este servidor proporciona un conjunto robusto de herramientas y capacidades que permiten a los LLM leer, administrar y operar los recursos de la Plataforma Heroku.

Características principales:

• Interacción directa con los recursos de la plataforma Heroku a través de herramientas impulsadas por LLM
• Acceso seguro y autenticado a las API de la plataforma Heroku, aprovechando la CLI de Heroku
• Interfaz de lenguaje natural para las interacciones en la plataforma Heroku

Nota: El servidor MCP de la plataforma Heroku se encuentra actualmente en fase inicial de desarrollo. A medida que mejoremos y refinemos la implementación, la funcionalidad y las herramientas disponibles podrían evolucionar. Agradecemos sus comentarios y contribuciones para contribuir al futuro de este proyecto.

Autenticación

Genere un token de autorización de Heroku con uno de estos métodos:

• Utilice el comando CLI de Heroku:
  heroku authorizations:create
• Utilice un token existente en la CLI
  heroku auth:token
  Copia el token y úsalo como tu HEROKU_API_KEY en los siguientes pasos.
• En tu panel de control de Heroku :
  1. Seleccione su avatar y luego seleccione Configuración de la cuenta .
  2. Abra la pestaña Aplicaciones.
  3. Junto a Autorizaciones , haga clic en Crear autorización .

Configurar el servidor MCP de la plataforma Heroku

Puede configurar Claude Desktop, Zed, Cursor y Windsurf para que funcionen con el servidor MCP de la plataforma Heroku.

Escritorio de Claude

Agregue este fragmento a su claude_desktop_config.json :

Zed

Añade este fragmento a tu archivo Zed settings.json :

Cursor

Agregue este fragmento a su Cursor mcp.json :

Windsurf

Agregue este fragmento a su Windsurf mcp_config.json :

Herramientas disponibles

Gestión de aplicaciones

• list_apps : Lista todas las apps de Heroku. Puedes filtrarlas por personal, colaborador, equipo o espacio.
• get_app_info : obtiene información detallada sobre una aplicación, incluida su configuración, dynos y complementos.
• create_app : crea una nueva aplicación con configuraciones personalizables para la región, el equipo y el espacio.
• rename_app - Cambiar el nombre de una aplicación existente.
• transfer_app - Transfiere la propiedad de una aplicación a otro usuario o equipo.
• deploy_to_heroku : implementa proyectos en Heroku con una configuración app.json , compatible con implementaciones de equipo, espacios privados y configuraciones de entorno.
• deploy_one_off_dyno : Ejecuta código o comandos en un entorno aislado en un dyno de Heroku. Admite creación de archivos, acceso a la red, variables de entorno y limpieza automática. Ideal para ejecutar scripts, pruebas o cargas de trabajo temporales.

Gestión de procesos y dinamómetros

• ps_list : enumera todos los dynos para una aplicación.
• ps_scale - Aumenta o reduce la cantidad de dinamómetros o cambia su tamaño.
• ps_restart : reinicia dinamos específicos, tipos de procesos o todos los dinamos.

Complementos

• list_addons : enumera todos los complementos para todas las aplicaciones o para una aplicación específica.
• get_addon_info : obtiene información detallada sobre un complemento específico.
• create_addon : proporciona un nuevo complemento para una aplicación.

Mantenimiento y registros

• maintenance_on : habilita el modo de mantenimiento para una aplicación.
• maintenance_off : deshabilita el modo de mantenimiento para una aplicación.
• get_app_logs : ver registros de la aplicación.

Gestión de tuberías

• pipelines_create - Crea una nueva tubería.
• pipelines_promote : promueve aplicaciones a la siguiente etapa de un pipeline.
• pipelines_list - Lista de pipelines disponibles.
• pipelines_info - Obtenga información detallada sobre las tuberías.

Gestión de equipos y espacios

• list_teams - Enumera los equipos a los que perteneces.
• list_private_spaces - Lista de espacios disponibles.

Gestión de bases de datos PostgreSQL

• pg_psql : ejecuta consultas SQL en la base de datos PostgreSQL de Heroku.
• pg_info - Muestra información detallada de la base de datos.
• pg_ps - Ver consultas activas y detalles de ejecución.
• pg_locks : ver bloqueos de base de datos e identificar transacciones de bloqueo.
• pg_outliers : identifica consultas que consumen muchos recursos.
• pg_credentials : administra las credenciales y el acceso a la base de datos.
• pg_kill - Finaliza procesos de base de datos específicos.
• pg_maintenance - Muestra información de mantenimiento de la base de datos.
• pg_backups - Administra copias de seguridad y programaciones de bases de datos.
• pg_upgrade : actualiza PostgreSQL a una versión más nueva.

Depuración

Puede utilizar el inspector MCP o la función Ejecutar y depurar de VS Code para ejecutar y depurar el servidor.

1. Vincula el proyecto como una CLI global usando npm link desde la raíz del proyecto.
2. Construya con npm run build:dev o observe los cambios de archivo y construya automáticamente con npm run build:watch .

Utilice el inspector MCP

Utilice el inspector MCP sin puntos de interrupción en el código:

Alternativamente, si instaló el paquete en un directorio específico o está desarrollando activamente en el servidor Heroku MCP:

Utilice la función Ejecutar y depurar de VS Code

Utilice el iniciador de ejecución y depuración de VS Code con puntos de interrupción completamente funcionales en el código:

1. Localice y seleccione ejecutar depuración.
2. Seleccione la configuración denominada " MCP Server Launcher " en el menú desplegable.
3. Seleccione el botón ejecutar/depurar.

Configuración de depuración del cursor/VS Code

Para configurar la depuración local con puntos de interrupción:

1. Guarda tu token de autenticación de Heroku en la configuración de usuario de VS Code:
   • Abra la paleta de comandos (Cmd/Ctrl + Shift + P).
   • Preferences: Open User Settings (JSON) .
   • Añade el siguiente fragmento:
   { "heroku.mcp.authToken": "your-token-here" }
2. Crear o actualizar .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. Crear .vscode/tasks.json :
   { "version": "2.0.0", "tasks": [ { "type": "npm", "script": "build:watch", "group": { "kind": "build", "isDefault": true }, "problemMatcher": ["$tsc"] } ] }
4. (Opcional) Establezca puntos de interrupción en sus archivos TypeScript.
5. Presione F5 o utilice la barra lateral Run and Debug .

Nota: el depurador crea automáticamente sus archivos TypeScript antes de iniciarse.