heroku-mcp-server

基本能力

产品定位

Heroku Platform MCP Server 是一个专为 Heroku 平台设计的模型上下文协议（MCP）实现，旨在促进大型语言模型（LLMs）与 Heroku 平台之间的无缝交互。

核心功能

• 直接通过 LLM 驱动的工具与 Heroku 平台资源交互
• 通过 Heroku CLI 安全认证访问 Heroku 平台 API
• 为 Heroku 平台交互提供自然语言界面

适用场景

• 自动化管理 Heroku 应用
• 部署和管理 Heroku 上的项目
• 监控和维护 Heroku 应用
• 团队和空间管理
• PostgreSQL 数据库管理

工具列表

应用管理

• list_apps - 列出所有 Heroku 应用
• get_app_info - 获取应用的详细信息
• create_app - 创建新应用
• rename_app - 重命名现有应用
• transfer_app - 将应用所有权转移给其他用户或团队
• deploy_to_heroku - 部署项目到 Heroku
• deploy_one_off_dyno - 在 Heroku 一次性 dyno 中执行代码或命令

进程和 Dyno 管理

• ps_list - 列出应用的所有 dynos
• ps_scale - 扩展或缩减 dynos 数量
• ps_restart - 重启特定 dynos

插件管理

• 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 - 在 Heroku PostgreSQL 数据库中执行 SQL 查询
• pg_info - 显示数据库详细信息
• pg_ps - 查看活动查询和执行详情
• pg_locks - 查看数据库锁和识别阻塞事务
• pg_outliers - 识别资源密集型查询
• pg_credentials - 管理数据库凭证和访问
• pg_kill - 终止特定数据库进程
• pg_maintenance - 显示数据库维护信息
• pg_backups - 管理数据库备份和计划
• pg_upgrade - 升级 PostgreSQL 到新版本

常见问题解答

• 如何生成 Heroku 授权令牌？
• 使用 Heroku CLI 命令：heroku authorizations:create 或 heroku auth:token
• 在 Heroku 仪表板中创建授权

使用教程

使用依赖

• 需要安装 Heroku CLI
• 需要 Node.js 和 npm

安装教程

1. 生成 Heroku 授权令牌 sh heroku authorizations:create 或 sh heroku auth:token
2. 配置 MCP 服务器 根据使用的工具（如 Claude Desktop、Zed、Cursor、Windsurf、Cline、VSCode、Trae）添加相应的配置片段

调试方式

1. 使用 MCP 检查器 sh npx @modelcontextprotocol/inspector heroku-mcp-server
2. 使用 VS Code 运行和调试功能
3. 设置 .vscode/launch.json 和 .vscode/tasks.json
4. 按 F5 启动调试

许可证

该项目遵循 Apache-2.0 开源许可条款，请参阅 Apache-2.0 了解完整条款。