mcp/heroku Docker Image Overview

mcp/heroku

基于Heroku CLI的Heroku平台MCP服务器，提供34种工具用于应用创建、部署、附加组件管理、数据库维护、管道配置等Heroku平台全生命周期操作，支持团队协作与私有空间部署。

2 收藏0 次下载

📦 一套镜像服务，解决研发 / 测试 / 生产三套环境

中文简介版本下载

📦 一套镜像服务，解决研发 / 测试 / 生产三套环境

Heroku MCP服务器

基于Heroku CLI的Heroku平台MCP服务器。

什么是MCP服务器？

特性

属性	详情
Docker镜像	mcp/heroku
作者	heroku
代码仓库	[***]
Dockerfile	[***]
Docker镜像构建者	Docker Inc.
Docker Scout健康评分	!Docker Scout Health Score
验证签名	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/heroku --key [***]`
许可证	Apache License 2.0

可用工具（34种）

服务器提供的工具	简短描述
`create_addon`	创建附加组件：指定服务、计划、自定义名称
`create_app`	创建应用：自定义名称、地区（US/EU）、团队、私有空间
`deploy_one_off_dyno`	在Heroku一次性dyno中运行代码/命令，具备网络和文件系统访问权限
`deploy_to_heroku`	用于所有部署操作
`get_addon_info`	获取附加组件详情：计划、状态、计费信息
`get_app_info`	获取应用详情：配置、dyno、附加组件、访问权限、域名
`get_app_logs`	应用日志：监控/调试/按dyno/进程/来源筛选
`list_addon_plans`	列出服务计划：功能、定价、可用性
`list_addon_services`	列出可用附加组件服务及功能
`list_addons`	列出附加组件：所有应用或特定应用，含详细元数据
`list_apps`	列出Heroku应用：拥有的、协作者访问的、按团队/空间筛选
`list_private_spaces`	列出Heroku私有空间，含CIDR块、地区、合规性和容量详情
`list_teams`	列出可访问的Heroku团队
`maintenance_off`	禁用维护模式，恢复应用正常运行
`maintenance_on`	启用维护模式，重定向Heroku应用流量
`pg_backups`	管理备份：计划、状态、验证、恢复
`pg_credentials`	管理访问权限：凭据、权限、安全、监控
`pg_info`	查看数据库状态：配置、指标、资源、健康状况
`pg_kill`	终止进程：卡住的查询、阻塞事务、失控操作
`pg_locks`	分析锁：阻塞查询、死锁、并发问题
`pg_maintenance`	跟踪维护：窗口、计划、进度、规划
`pg_outliers`	查找资源密集型查询：性能、模式、优化建议
`pg_ps`	监控活动查询：进度、资源、性能
`pg_psql`	执行SQL查询：分析、调试、修改架构、管理数据
`pg_upgrade`	升级PostgreSQL：版本迁移、兼容性、安全性
`pipelines_create`	创建新的Heroku部署管道，含可配置阶段、应用和团队设置
`pipelines_info`	显示管道详细配置、阶段和关联应用
`pipelines_list`	列出可访问的Heroku管道，含所有权和配置详情
`pipelines_promote`	在管道阶段间推广应用，支持可配置目标应用
`ps_list`	列出和监控Heroku应用dyno
`ps_restart`	重启Heroku应用进程
`ps_scale`	扩展Heroku应用dyno
`rename_app`	重命名应用：验证并更新应用名称
`transfer_app`	转移应用所有权给用户/团队

工具详情

工具：`create_addon`

创建附加组件：指定服务、计划、自定义名称

参数	类型	描述
`app`	`string`	附加组件的目标应用。需具备写入权限。地区/空间影响可用性
`serviceAndPlan`	`string`	格式：服务标识符:计划标识符（例如：heroku-postgresql:essential-0）
`as`	`string` 可选	自定义附加组件名称。用于配置变量前缀。必须在应用中唯一
`name`	`string` 可选	全局附加组件标识符。必须在所有Heroku附加组件中唯一

工具：`create_app`

创建应用：自定义名称、地区（US/EU）、团队、私有空间

参数	类型	描述
`app`	`string` 可选	应用名称。若省略则自动生成
`region`	`string` 可选	地区：us/eu。默认：us。与space参数互斥
`space`	`string` 可选	私有空间名称。继承地区。与region参数互斥
`team`	`string` 可选	拥有应用的团队名称

工具：`deploy_one_off_dyno`

在Heroku一次性dyno中运行代码/命令，具备网络和文件系统访问权限。

要求：

显示命令输出
使用app_info进行构建包检测
支持shell设置命令
使用stdout/stderr

特性：

网络/文件系统访问
环境变量
文件操作
临时目录处理

使用方法：

使用Heroku运行时
正确的语法/导入
结构化的代码组织
包管理：
- 定义依赖
- 最小化外部依赖
- 优先使用原生模块

示例package.json：

json
{
  "type": "module",
  "dependencies": {
    "axios": "^1.6.0"
  }
}

参数	类型	描述
`command`	`string`	在dyno中运行的命令
`name`	`string`	目标Heroku应用名称
`env`	`object` 可选	dyno环境变量
`size`	`string` 可选	dyno大小
`sources`	`array` 可选	包含在dyno中的源文件
`timeToLive`	`number` 可选	dyno生命周期（秒）

工具：`deploy_to_heroku`

用于所有部署操作。部署新/现有应用，支持团队/空间部署及环境变量配置。若缺少应用名称则需询问。需通过appJson参数提供有效的app.json。

参数	类型	描述
`appJson`	`string`	部署用的app.json配置。必须遵循schema：{"default":{"$schema":"[**]","title":"Heroku app.json Schema","description":"app.json是描述Web应用的清单格式。它声明在Heroku上运行应用所需的环境变量、附加组件和其他信息。用于动态配置或转换项目","type":"object","properties":{"name":{"type":"string","pattern":"^[a-zA-Z-\.]+","maxLength":300},"description":{"type":"string"},"keywords":{"type":"array","items":{"type":"string"}},"website":{"$ref":"#/definitions/uriString"},"repository":{"$ref":"#/definitions/uriString"},"logo":{"$ref":"#/definitions/uriString"},"success_url":{"type":"string"},"scripts":{"$ref":"#/definitions/scripts"},"env":{"$ref":"#/definitions/env"},"formation":{"$ref":"#/definitions/formation"},"addons":{"$ref":"#/definitions/addons"},"buildpacks":{"$ref":"#/definitions/buildpacks"},"environments":{"$ref":"#/definitions/environments"},"stack":{"$ref":"#/definitions/stack"},"image":{"type":"string"}},"additionalProperties":false,"definitions":{"uriString":{"type":"string","format":"uri"},"scripts":{"type":"object","properties":{"postdeploy":{"type":"string"},"pr-predestroy":{"type":"string"}},"additionalProperties":false},"env":{"type":"object","patternProperties":{"^[A-Z][A-Z0-9]$":{"type":"object","properties":{"description":{"type":"string"},"value":{"type":"string"},"required":{"type":"boolean"},"generator":{"type":"string","enum":["secret"]}},"additionalProperties":false}}},"dynoSize":{"type":"string","enum":["free","eco","hobby","basic","standard-1x","standard-2x","performance-m","performance-l","private-s","private-m","private-l","shield-s","shield-m","shield-l"]},"formation":{"type":"object","patternProperties":{"^[a-zA-Z0-9_-]+$":{"type":"object","properties":{"quantity":{"type":"integer","minimum":0},"size":{"$ref":"#/definitions/dynoSize"}},"required":["quantity"],"additionalProperties":false}}},"addons":{"type":"array","items":{"oneOf":[{"type":"string"},{"type":"object","properties":{"plan":{"type":"string"},"as":{"type":"string"},"options":{"type":"object"}},"required":["plan"],"additionalProperties":false}]}},"buildpacks":{"type":"array","items":{"type":"object","properties":{"url":{"type":"string"}},"required":["url"],"additionalProperties":false}},"environmentConfig":{"type":"object","properties":{"env":{"type":"object"},"formation":{"type":"object"},"addons":{"type":"array"},"buildpacks":{"type":"array"}}},"environments":{"type":"object","properties":{"test":{"allOf":[{"$ref":"#/definitions/environmentConfig"},{"type":"object","properties":{"scripts":{"type":"object","properties":{"test":{"type":"string"}},"additionalProperties":false}}}]},"review":{"$ref":"#/definitions/environmentConfig"},"production":{"$ref":"#/definitions/environmentConfig"}},"additionalProperties":false},"stack":{"type":"string","enum":["heroku-18","heroku-20","heroku-22","heroku-24"]}}}}
`name`	`string`	部署的应用名称。若不存在则创建新应用
`rootUri`	`string`	工作区根目录路径
`env`	`object` 可选	覆盖app.json值的环境变量
`internalRouting`	`boolean` 可选	在私有空间中启用内部路由
`spaceId`	`string` 可选	空间部署的私有空间ID
`tarballUri`	`string` 可选	部署tarball的URL。若未提供则从rootUri创建
`teamId`	`string` 可选	团队部署的团队ID

工具：`get_addon_info`

获取附加组件详情：计划、状态、计费信息

参数	类型	描述
`addon`	`string`	附加组件标识符：UUID、名称（postgresql-curved-***）或附加名称（DATABASE）
`app`	`string` 可选	附加组件查找的应用上下文。附加名称需要。使用Git远程默认值

工具：`get_app_info`

获取应用详情：配置、dyno、附加组件、访问权限、域名

参数	类型	描述
`app`	`string`	目标应用名称。需具备访问权限
`json`	`boolean` 可选	带完整元数据的JSON输出。默认：文本格式

工具：`get_app_logs`

应用日志：监控/调试/按dyno/进程/来源筛选

参数	类型	描述
`app`	`string`	Heroku应用名称。要求：权限、Cedar-gen
`dynoName`	`string` 可选	格式：web.1/worker.2。与processType互斥
`processType`	`string` 可选	web
`source`	`string` 可选	app=应用程序，heroku=平台。默认：所有

工具：`list_addon_plans`

列出服务计划：功能、定价、可用性

参数	类型	描述
`service`	`string`	服务标识符（例如：heroku-postgresql）。从list_addon_services获取
`json`	`boolean` 可选	带定价、功能、空间兼容性的JSON输出。默认：文本格式

工具：`list_addon_services`

列出可用附加组件服务及功能

参数	类型	描述
`json`	`boolean` 可选	带共享选项和应用生成支持的JSON输出。默认：基本文本

工具：`list_addons`

列出附加组件：所有应用或特定应用，含详细元数据

参数	类型	描述
`all`	`boolean` 可选	列出所有可访问应用的附加组件。覆盖app参数，显示完整状态
`app`	`string` 可选	按应用名称筛选。显示附加组件和附加信息。若省略则使用Git远程默认值

工具：`list_apps`

列出Heroku应用：拥有的、协作者访问的、按团队/空间筛选

参数	类型	描述
`all`	`boolean` 可选	显示拥有的应用和协作者访问的应用。默认：仅显示拥有的
`personal`	`boolean` 可选	仅列出个人账户应用，忽略默认团队
`space`	`string` 可选	按私有空间名称筛选。与team参数互斥
`team`	`string` 可选	按团队名称筛选。与space参数互斥