MCP 服务器

Heroku MCP server

Okay, I understand. You want me to translate the phrase "Let's your agent access the Heroku platform" into Chinese. Here are a few options, depending on the nuance you want to convey: **Option 1 (Most Direct):** * **让你的代理访问 Heroku 平台 (Ràng nǐ de dàilǐ fǎngwèn Heroku píngtái)** * This is the most literal translation. * `让 (ràng)`: Let, allow * `你的代理 (nǐ de dàilǐ)`: Your agent * `访问 (fǎngwèn)`: Access, visit * `Heroku 平台 (Heroku píngtái)`: Heroku platform **Option 2 (Slightly More Natural, Implies Permission):** * **允许你的代理访问 Heroku 平台 (Yǔnxǔ nǐ de dàilǐ fǎngwèn Heroku píngtái)** * This emphasizes the granting of permission. * `允许 (yǔnxǔ)`: Allow, permit **Option 3 (Focus on Enabling Access):** * **让你的代理能够访问 Heroku 平台 (Ràng nǐ de dàilǐ nénggòu fǎngwèn Heroku píngtái)** * This emphasizes the capability of accessing. * `能够 (nénggòu)`: Be able to, can **Which option is best depends on the context. If you're simply stating a desire, Option 1 is fine. If you're talking about granting permission, Option 2 is better. If you're talking about ensuring the agent *can* access it, Option 3 is best.** Therefore, I recommend **让你的代理访问 Heroku 平台 (Ràng nǐ de dàilǐ fǎngwèn Heroku píngtái)** as the most generally applicable translation.

README

heroku-mcp-server

概述

Heroku Platform MCP Server 是一个专门的模型上下文协议 (MCP) 实现，旨在促进大型语言模型与 Heroku 平台之间的无缝交互。该服务器旨在提供一套强大的工具和功能，使 LLM 能够读取、管理和操作 Heroku 平台资源。

主要特性：

通过 LLM 驱动的工具直接与 Heroku 平台资源交互
安全且经过身份验证的 Heroku 平台 API 访问，利用 Heroku CLI
用于 Heroku 平台交互的自然语言界面

注意：Heroku Platform MCP Server 目前处于早期开发阶段。随着我们不断增强和完善实现，可用的功能和工具可能会不断发展。我们欢迎反馈和贡献，以帮助塑造该项目的未来。

安装

使用 npm 在全局范围内安装 Heroku Platform MCP Server：

npm -i -g @heroku/mcp-server

配置

身份验证设置

使用以下方法之一生成 Heroku 授权令牌：

通过您的 Heroku Dashboard 帐户配置文件
使用 Heroku CLI 命令：
```
  heroku authorizations:create
```

复制令牌并在以下步骤中将其用作您的 HEROKU_API_KEY。

与 Claude Desktop 一起使用

将其添加到您的 claude_desktop_config.json：

"mcpServers": {
  "heroku": {
    "command": "heroku-mcp-server",
    "env": {
      "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>"
    }
  }
}

与 Zed 一起使用

将其添加到您的 Zed settings.json：

"context_servers": [
  "heroku-mcp-server": {
    "command": {
      "path": "heroku-mcp-server",
      "env": {
        "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>"
      }
    }
  }
],

与 Cursor 一起使用

将其添加到您的 Cursor mcp.json：

"mcpServers": {
  "heroku": {
    "command": "heroku-mcp-server",
    "env": {
      "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>"
    }
  },
}

与 Windsurf 一起使用

将其添加到您的 Windsurf mcp_config.json：

"mcpServers": {
  "heroku": {
    "command": "heroku-mcp-server",
    "env": {
      "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>"
    }
  },
}

调试

您可以使用 MCP 检查器或 vscode 运行/调试来运行和调试服务器。

使用项目根目录中的 npm link 将项目链接为全局 CLI
使用 npm run build:dev 构建，或者；
要监视文件更改并自动构建，请使用 npm run build:watch

选项 1 - 使用 @modelcontextprotocol/inspector（代码中没有断点）：

# 断点不可用
npx @modelcontextprotocol/inspector heroku-mcp-server

选项 2 - 使用 VSCode 运行/调试启动器（代码中具有完整功能的断点）：

找到并单击运行调试
在下拉列表中选择标记为“MCP Server Launcher”的配置
单击绿色的运行/调试按钮

或者，如果您已将软件包安装在特定目录中或正在对其进行开发：

cd path/to/servers/src/git
npx @modelcontextprotocol/inspector dist/index.js

VS Code / Cursor 调试设置

要设置带有断点的本地调试：

将您的 Heroku 身份验证令牌存储在 VS Code 用户设置中：
- 打开命令面板 (Cmd/Ctrl + Shift + P)
- 键入“Preferences: Open User Settings (JSON)”
- 添加以下内容：
```
{
  "heroku.mcp.authToken": "your-token-here"
}
```

创建或更新 .vscode/launch.json：

{
  "version": "0.2.0",
  "configurations": [
    {
      "type": "node",
      "request": "launch",
      "name": "MCP Server Launcher",
      "skipFiles": ["<node_internals>/**"],
      "program": "${workspaceFolder}/node_modules/@modelcontextprotocol/inspector/bin/cli.js",
      "outFiles": ["${workspaceFolder}/**/dist/**/*.js"],
      "env": {
        "HEROKU_API_KEY": "${config:heroku.mcp.authToken}",
        "DEBUG": "true"
      },
      "args": ["heroku-mcp-server"],
      "sourceMaps": true,
      "console": "integratedTerminal",
      "internalConsoleOptions": "neverOpen",
      "preLaunchTask": "npm: build:watch"
    },
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to Debug Hook Process",
      "port": 9332,
      "skipFiles": ["<node_internals>/**"],
      "sourceMaps": true,
      "outFiles": ["${workspaceFolder}/dist/**/*.js"]
    },
    {
      "type": "node",
      "request": "attach",
      "name": "Attach to REPL Process",
      "port": 9333,
      "skipFiles": ["<node_internals>/**"],
      "sourceMaps": true,
      "outFiles": ["${workspaceFolder}/dist/**/*.js"]
    }
  ],
  "compounds": [
    {
      "name": "Attach to MCP Server",
      "configurations": ["Attach to Debug Hook Process", "Attach to REPL Process"]
    }
  ]
}

创建 .vscode/tasks.json：

{
  "version": "2.0.0",
  "tasks": [
    {
      "type": "npm",
      "script": "build:watch",
      "group": {
        "kind": "build",
        "isDefault": true
      },
      "problemMatcher": ["$tsc"]
    }
  ]
}