mcp/heroku

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

2 次收藏下载次数: 0状态：社区镜像维护者：mcp（Model Context Protocol）仓库类型：镜像最近更新：1 年前

让 AI 帮你使用轩辕镜像？ · 展开查看说明

如果你使用 DeepSeek、元宝 AI、Copilot、ChatGPT 等 AI 工具，协助配置轩辕镜像、编写 docker pull 命令、修改 Docker Compose 镜像地址、配置镜像加速、排查镜像拉取失败、分析报错日志等问题，请先让 AI 阅读并遵守轩辕镜像的规则文档。

只需在 AI 对话中先发送下面这句话即可：

请先完整阅读并严格遵守以下文档中的全部规则与要求：

https://xuanyuan.cloud/agents.md

在未充分阅读并理解该文档前，不要生成任何命令、配置、修改建议、故障排查方案或技术回答。后续所有输出都必须严格以该文档中的规范为最高优先级执行。

查看 agents.md 用法指南与完整示范。国内用户首推元宝 AI、DeepSeek 的深度思考模式，不推荐豆包 AI；Cursor 等编辑器可在对话 @ 该链接，或加入 User Rules。若 AI 无法访问外链，可打开说明文档复制全文粘贴。文档会随站点更新，复制内容可能过期，建议定期检查。

镜像标签列表与下载命令

Heroku MCP服务器

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

https://www.anthropic.com/news/model-context-protocol

特性

属性	详情
Docker镜像	https://hub.docker.com/repository/docker/mcp/heroku
作者	https://github.com/heroku
代码仓库	https://github.com/heroku/heroku-mcp-server
Dockerfile	https://github.com/heroku/heroku-mcp-server/blob/refs/pull/24/merge/Dockerfile
Docker镜像构建者	Docker Inc.
Docker Scout健康评分
验证签名	`COSIGN_REPOSITORY=mcp/signatures cosign verify mcp/heroku --key https://raw.githubusercontent.com/docker/keyring/refs/heads/main/public/mcp/latest.pub`
许可证	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":"http://json-schema.org/draft-07/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参数互斥

工具：`list_private_spaces`

列出Heroku私有空间，含CIDR块、地区、合规性和容量详情。支持JSON输出。

参数	类型	描述
`json`	`boolean` 可选	详细空间元数据的JSON输出，若为false/省略则为文本输出

工具：`list_teams`

列出可访问的Heroku团队。用途：查看团队、检查成员资格、获取团队元数据、验证访问权限。支持JSON输出。

参数	类型	描述
`json`	`boolean` 可选	输出格式控制 - true表示带团队元数据的详细JSON，false/省略表示简化文本

工具：`maintenance_off`

禁用维护模式，恢复应用正常运行

参数	类型	描述
`app`	`string`	目标Heroku应用名称

工具：`maintenance_on`

启用维护模式，重定向Heroku应用流量

参数	类型	描述
`app`	`string`	目标Heroku应用名称

工具：`pg_backups`

管理备份：计划、状态、验证、恢复

参数	类型	描述
`app`	`string`	目标应用名称

工具：`pg_credentials`

管理访问权限：凭据、权限、安全、监控

参数	类型	描述
`app`	`string`	目标应用名称
`database`	`string` 可选	数据库标识符。格式：其他应用使用APP_NAME::DB。默认：DATABASE_URL

工具：`pg_info`

查看数据库状态：配置、指标、资源、健康状况

参数	类型	描述
`app`	`string`	目标应用名称
`database`	`string`

镜像拉取方式

您可以使用以下命令拉取该镜像。请将 <标签> 替换为具体的标签版本。如需查看所有可用标签版本，请访问标签列表页面。

轩辕镜像加速拉取命令点我查看更多 heroku 镜像标签

docker pull docker.xuanyuan.run/mcp/heroku:<标签>

使用方法：

DockerHub 原生拉取命令

docker pull mcp/heroku:<标签>

轩辕镜像配置手册

按平台快速找到配置文档

一键安装

一键安装 Docker

Linux Docker 一键安装

AI

用 AI 使用轩辕镜像

agents.md · AI 对话 · 提示词

Docker

登录仓库拉取

登录认证 · 私有仓库

专属域名拉取

免登录 · 高速拉取

Linux

Docker 镜像配置

Windows / Mac

Docker Desktop 配置

MacOS OrbStack

OrbStack 容器

Apple Container

macOS 原生容器

Docker Compose

Compose 项目配置

NAS

群晖

Synology 配置

飞牛

fnOS 镜像配置

绿联

绿联 NAS

威联通

QNAP 配置

极空间

极空间 NAS

Unraid

Unraid NAS

企业仓库

其他仓库

ghcr · Quay · nvcr

Harbor 镜像源

Proxy Repository 对接

Portainer 镜像源

Registries 配置

Nexus 镜像源

Docker Proxy 缓存

开发工具

Dev Containers

VS Code 开发容器

Podman

Podman 配置指南

Singularity / Apptainer

HPC 科学计算容器

Kubernetes

K8s Containerd

Kubernetes · Containerd

K3s

轻量级集群

面板 / 网络

爱快路由

爱快 4.0 · iKuai 镜像加速

宝塔面板

一键配置镜像源

需要其他帮助？请查看我们的常见问题Docker 镜像访问常见问题解答或提交工单

镜像拉取常见问题

功能

版本功能对比

功能对比 · 版本选择

支持的镜像仓库

Docker Hub · GCR · GHCR

专属域名用法

专属域名 · 开启停用 · 多仓库

新手拉取配置

docker search 限制

专属域名 · Hub 搜索

不支持 push

仅支持 pull · 不支持

拉取速度原因

带宽 · 缓存 · 冷热镜像

错误码

402 与流量用尽

402 · 流量包 · 充值

401 认证失败

401 · docker login

manifest unknown

标签错误 · 镜像不存在

410 Gone 排查

410 · Docker 升级

429 限流

免费版 · 专业版 · 企业版 · 请求频率

其他报错

DNS 超时

DNS 解析 · 网络超时

TLS 证书失败

no matching manifest（架构）

docker.sock / daemon

账号

失败是否计费

manifest · blob · 计费

申请开票（企业 / 个人）

开票 · 发票 · 工单

修改登录密码

网站 · 仓库 · 重置

注销账户

工单 · 数据 · 注销

原理

mirrors 不生效

daemon.json · 重启

去掉域名前缀

docker tag · 重命名

指定架构拉取

ARM64 · AMD64 · 多架构

latest 与「最新」

digest · 版本号 · 标签

查看全部问题→

用户好评

来自真实用户的反馈，见证轩辕镜像的优质服务

oldzhang

运维工程师

Linux服务器

"Docker访问体验非常流畅，大镜像也能快速完成下载。"