Heroku Build Logs MCP Server

Heroku构建日志MCP服务器

概述

Heroku构建日志MCP服务器是一个模型上下文协议（MCP）服务器，它公开了一个用于检索指定Heroku应用程序的最新构建日志的工具。这允许像Cursor这样的代理快速获取和处理构建日志，使他们能够诊断构建失败的原因。

特性

• 显示单个工具： get-latest-build-logs 这允许您的代理获取给定应用程序的最新构建日志。

安装说明

1.克隆和安装依赖项

git clone github.com/samtessema9/heroku-build-logs-mcp-server
cd heroku-build-logs-mcp-server
npm install

2.设置所需的环境变量

您必须为生产环境提供Heroku API令牌：

• HEROKU_AUTH_TOKEN_PRODUCTION --对于生产应用程序（您可以通过运行 heroku auth:token)

注： 这 staging 环境仅供内部工程师使用。 外部用户不需要设置任何临时凭据或包含 environment 参数在他们的请求。您的所有应用程序，包括临时应用程序，都被视为在生产环境中运行。

你可以在shell中设置它 .env 文件， 或者直接在Cursor MCP配置中 （见下文）：

export HEROKU_AUTH_TOKEN_PRODUCTION=your_production_token

3.重建项目（可选）

注： 该项目已经建成。只有在对中的代码进行任何修改时，才需要运行此步骤 src 说 。

npm run build

与Cursor MCP集成

将以下条目添加到您的 .cursor/mcp.config.json:

{
  "servers": [
    {
      "name": "heroku-build-logs",
      "transport": "stdio",
      "command": "node build/index.js",
      "env": {
        "HEROKU_AUTH_TOKEN_PRODUCTION": "your_heroku_token"
      }
    }
  ]
}

在添加配置之后， 重新启动游标。然后，通过转到以下步骤验证服务器是否已正确添加：

Cursor → Settings → Cursor Settings → MCP

您应该看到MCP服务器中列出的“heroku构建日志”服务器。

与其他代理商或定制客户集成

虽然此README提供了与Cursor集成的说明，但MCP构建日志服务器是一个标准的MCP服务器，可以与任何支持stdio或其他支持传输的模型上下文协议（MCP）的代理或自定义客户端集成。您可以使用上述相同的工具界面和参数从您自己的应用程序或自动化脚本查询服务器。

有关如何连接到外部MCP服务器的详细信息，请参阅您的代理或客户的文档。

工具文档

get-latest-build-logs

获取指定Heroku应用程序的最新构建日志。

参数：

• appName （string，必填）：Heroku应用程序名称（如您的Heroku仪表板所示）。
• environment （枚举，可选）： "production" （外部用户的默认设置）或 "staging" （仅限内部工程师）。

注： 这 environment 参数是可选的。 外部用户不需要包含它。

退货：

• 最新版本的完整日志，如果找不到版本或日志不可用，则显示错误消息。

自然语言查询示例

“显示应用程序的最新构建日志 my-cool-app 在生产中。"

故障排除

• 确保您的Heroku API令牌有效，并且可以访问指定的应用程序。
• 如果您看到有关缺少环境变量的错误，请仔细检查您的设置。
• 服务器在启动时和出现致命错误时会登录到stderr。

许可证

该项目根据ISC许可证获得许可。