Heroku Platform MCP Server（@heroku/mcp-server）

技能简介

Heroku Platform MCP Server 是 Heroku 官方推出的 Model Context Protocol 服务，用于在大语言模型与 Heroku 云平台之间建立安全、顺畅的交互通道。它把 Heroku 平台的应用、进程、附加组件、流水线、团队空间乃至 PostgreSQL 数据库等资源，封装成一组可由 LLM 驱动的工具，让开发者可以用自然语言完成平台资源的读取、管理与运维操作，而无需在浏览器后台里逐层点击。该服务可在 Common Runtime、Cedar Private 与 Shield Spaces 以及 Fir Private Spaces 上工作，适合不同规模与合规要求的团队。

核心能力

• 应用管理：通过 LLM 驱动的工具直接读取与操作 Heroku 应用资源，覆盖应用信息、配置等常用维度。
• 进程与 Dyno 管理：查看和管理进程（Process）与 Dyno，便于排查实例状态与扩容缩容。
• 附加组件（Add-ons）：管理应用所依赖的 Add-ons，简化资源开通与挂载。
• 维护与日志：执行维护相关操作并读取日志，用于线上问题排查。
• 流水线管理：面向 Heroku Pipelines，支持在流水线层面组织应用的交付链路。
• 团队与空间管理：管理 Team 与 Space，适配企业级多团队协作场景。
• PostgreSQL 数据库管理：面向 Heroku Postgres 提供专门的数据库管理工具。
• 多种客户端适配：官方给出 Claude Desktop、Zed、Cursor、Windsurf、Cline、VS Code、Trae 等客户端的配置示例。
• 安全的鉴权方式：推荐使用 heroku mcp:start，直接复用 Heroku CLI 已有的登录上下文，无需额外暴露 API Key。
• 自然语言交互：把平台操作抽象为对话式指令，降低运维门槛。

安装配置

1. 安装 Heroku CLI：需要全局安装 Heroku CLI，版本要求 10.8.1 或以上，可用 heroku --version 确认版本。
2. 方式一（推荐）heroku mcp:start：该命令在 CLI 10.8.1+ 提供，直接复用你当前的 CLI 登录认证，无需管理或暴露 HEROKU_API_KEY。
3. 方式二 npx -y @heroku/mcp-server：如果你偏好独立运行，可通过 npx 启动，此时需要在配置中通过 HEROKU_API_KEY 环境变量提供密钥。
4. 生成 API Key：若采用方式二，请在 Heroku 后台生成授权令牌（API Key）并填入配置。
5. 写入客户端配置：以 Claude Desktop 为例，在 mcpServers 中新增一个名为 heroku 的条目，命令填 heroku mcp:start 或 npx -y @heroku/mcp-server。
6. 可选：超时设置：可通过 MCP_SERVER_REQUEST_TIMEOUT 环境变量调整请求超时时间。

使用步骤

1. 升级并登录 Heroku CLI，确认 heroku --version 不低于 10.8.1。
2. 在所使用的 AI 客户端中按官方示例添加 Heroku MCP Server 配置。
3. 重启客户端，确认工具列表中已加载 Heroku 相关工具集。
4. 用自然语言提出需求，例如「列出我名下的所有应用」或「查看某个应用的 Dyno 状态」。
5. 智能体调用对应工具，读取或操作 Heroku 平台资源，并把结果返回给你。
6. 如需排查问题，可结合日志工具与 MCP Inspector 进行调试（官方文档提供 Inspector 与 VS Code 调试指引）。

适用场景

• 应用日常运维：用对话方式查看应用状态、重启进程、检查 Dyno，减少后台点击。
• 部署与交付链路管理：通过流水线工具组织 staging 到 production 的交付。
• 线上故障排查：快速读取日志与维护状态，定位异常。
• 数据库运维：对 Heroku Postgres 执行查看与管理操作。
• 团队与空间治理：在 AI 辅助下管理 Team 与 Space 的资源分配。
• AI 自动化运维试点：把平台操作下沉给智能体，探索自然语言驱动的 DevOps 流程。

适用人群

• 使用 Heroku 部署应用的独立开发者与小型团队
• 负责平台运维、需要频繁查看应用与日志的 DevOps 工程师
• 采用 Heroku Pipelines 做多环境交付的研发团队
• 希望把 AI 助手接入云平台运维流程的技术负责人

工作原理

Heroku Platform MCP Server 是一个专门实现的 MCP 服务，充当大语言模型与 Heroku 平台之间的桥梁。它通过 Heroku CLI（heroku mcp:start）或 npx -y @heroku/mcp-server 启动，并以 stdio 传输与客户端通信。在鉴权上，推荐路径复用 Heroku CLI 已有的登录上下文，避免额外管理 API Key；独立运行路径则依赖 HEROKU_API_KEY。服务器把平台能力封装为一系列工具，客户端加载后会把这些工具暴露给模型。当用户以自然语言下达指令时，模型依据工具描述选择合适的调用，服务器再通过 Heroku 平台 API 执行真实的读/写操作，并将结果回传给模型与用户。官方提示该项目仍处于早期开发阶段，可用功能与工具集可能持续演进。

官方链接

• npm 包：https://www.npmjs.com/package/@heroku/mcp-server
• 源码仓库：https://github.com/heroku/heroku-mcp-server
• 官方文档：https://devcenter.heroku.com/articles/heroku-mcp-server
• Heroku CLI 下载：https://devcenter.heroku.com/articles/heroku-cli