헤로쿠-mcp-서버

Heroku 플랫폼 MCP 서버는 Common Runtime, Cedar Private 및 Shield Spaces, Fir Private Spaces에서 작동합니다.

개요

Heroku 플랫폼 MCP 서버는 대규모 언어 모델(LLM)과 Heroku 플랫폼 간의 원활한 상호작용을 지원하도록 설계된 특수 모델 컨텍스트 프로토콜(MCP) 구현입니다. 이 서버는 LLM이 Heroku 플랫폼 리소스를 읽고, 관리하고, 운영할 수 있도록 지원하는 강력한 도구와 기능 세트를 제공합니다.

주요 특징:

LLM 기반 도구를 통해 Heroku 플랫폼 리소스와 직접 상호 작용
Heroku CLI를 활용하여 Heroku 플랫폼 API에 대한 안전하고 인증된 액세스
Heroku 플랫폼 상호 작용을 위한 자연어 인터페이스

참고: Heroku 플랫폼 MCP 서버는 현재 초기 개발 단계에 있습니다. 구현을 지속적으로 개선하고 개선함에 따라 사용 가능한 기능과 도구가 더욱 발전할 수 있습니다. 이 프로젝트의 미래를 형성하는 데 도움이 되는 여러분의 피드백과 기여를 환영합니다.

입증

다음 방법 중 하나를 사용하여 Heroku 인증 토큰을 생성하세요.

Heroku CLI 명령을 사용하세요:지엑스피1
CLI에서 기존 토큰 사용
heroku auth:token
토큰을 복사하여 다음 단계에서 HEROKU_API_KEY 로 사용하세요.
Heroku 대시보드 에서:
1. 아바타를 선택한 다음 계정 설정을 선택하세요.
2. 응용 프로그램 탭을 엽니다.
3. 권한 부여 옆에 있는 권한 부여 만들기를 클릭합니다.

Heroku 플랫폼 MCP 서버 구성

Claude Desktop, Zed, Cursor, Windsurf를 구성하여 Heroku Platform MCP Server와 함께 사용할 수 있습니다.

클로드 데스크탑

claude_desktop_config.json 에 이 스니펫을 추가하세요:

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

제드 자의 명칭

이 스니펫을 Zed settings.json 에 추가하세요:

{
  "context_servers": {
    "heroku": {
      "command": {
        "path": "npx",
        "args": ["-y", "@heroku/mcp-server"],
        "env": {
          "HEROKU_API_KEY": "<YOUR_HEROKU_AUTH_TOKEN>"
        }
      }
    }
  }
}

커서

Cursor mcp.json 에 이 스니펫을 추가하세요:

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

윈드서핑

Windsurf mcp_config.json 에 이 스니펫을 추가하세요:

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

사용 가능한 도구

애플리케이션 관리

list_apps - 모든 Heroku 앱을 나열합니다. 개인, 공동작업자, 팀 또는 스페이스별로 앱을 필터링할 수 있습니다.
get_app_info - 앱의 구성, 다이노, 애드온을 포함한 자세한 정보를 가져옵니다.
create_app - 지역, 팀, 공간에 대한 사용자 정의 설정으로 새로운 앱을 만듭니다.
rename_app - 기존 앱의 이름을 변경합니다.
transfer_app - 앱의 소유권을 다른 사용자나 팀으로 이전합니다.
deploy_to_heroku - app.json 구성을 사용하여 Heroku에 프로젝트를 배포하고 팀 배포, 개인 공간 및 환경 설정을 지원합니다.
deploy_one_off_dyno - Heroku 일회성 Dyno의 샌드박스 환경에서 코드나 명령을 실행합니다. 파일 생성, 네트워크 액세스, 환경 변수 및 자동 정리를 지원합니다. 스크립트, 테스트 또는 임시 워크로드 실행에 이상적입니다.

프로세스 및 다이노 관리

ps_list - 앱의 모든 다이노를 나열합니다.
ps_scale - 다이노의 개수를 늘리거나 줄이거나, 다이노의 크기를 조절합니다.
ps_restart - 특정 다이노, 프로세스 유형 또는 모든 다이노를 다시 시작합니다.

추가 기능

list_addons - 모든 앱 또는 특정 앱의 모든 애드온을 나열합니다.
get_addon_info - 특정 애드온에 대한 자세한 정보를 얻습니다.
create_addon - 앱에 대한 새로운 애드온을 제공합니다.

유지 관리 및 로그

maintenance_on - 앱의 유지 관리 모드를 활성화합니다.
maintenance_off - 앱의 유지 관리 모드를 비활성화합니다.
get_app_logs - 애플리케이션 로그를 봅니다.

파이프라인 관리

pipelines_create - 새로운 파이프라인을 생성합니다.
pipelines_promote - 파이프라인에서 앱을 다음 단계로 승격합니다.
pipelines_list - 사용 가능한 파이프라인을 나열합니다.
pipelines_info - 자세한 파이프라인 정보를 얻습니다.

팀 및 공간 관리

list_teams - 소속된 팀을 나열합니다.
list_private_spaces - 사용 가능한 공간을 나열합니다.

PostgreSQL 데이터베이스 관리

pg_psql - Heroku PostgreSQL 데이터베이스에 대해 SQL 쿼리를 실행합니다.
pg_info - 자세한 데이터베이스 정보를 표시합니다.
pg_ps - 활성 쿼리와 실행 세부 정보를 봅니다.
pg_locks - 데이터베이스 잠금을 보고 차단 트랜잭션을 식별합니다.
pg_outliers - 리소스를 많이 사용하는 쿼리를 식별합니다.
pg_credentials - 데이터베이스 자격 증명과 액세스를 관리합니다.
pg_kill - 특정 데이터베이스 프로세스를 종료합니다.
pg_maintenance - 데이터베이스 유지 관리 정보를 표시합니다.
pg_backups - 데이터베이스 백업 및 일정을 관리합니다.
pg_upgrade - PostgreSQL을 최신 버전으로 업그레이드합니다.

디버깅

MCP 검사기 나 VS Code 실행 및 디버그 기능을 사용하여 서버를 실행하고 디버깅할 수 있습니다.

프로젝트 루트에서 npm link 사용하여 프로젝트를 글로벌 CLI로 연결합니다.
npm run build:dev 로 빌드하거나, npm run build:watch 로 파일 변경 사항을 감시하고 자동으로 빌드합니다.

MCP 검사기를 사용하세요

코드에 중단점 없이 MCP 검사기를 사용하세요.

# Breakpoints are not available
npx @modelcontextprotocol/inspector heroku-mcp-server

또는 특정 디렉토리에 패키지를 설치했거나 Heroku MCP 서버에서 적극적으로 개발 중인 경우:

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

VS Code 실행 및 디버그 기능 사용

코드에서 완벽한 기능을 갖춘 중단점을 갖춘 VS Code 실행 및 디버그 런처를 사용하세요.

실행 디버그를 찾아 선택합니다.
드롭다운에서 " MCP Server Launcher "라고 표시된 구성을 선택합니다.
실행/디버그 버튼을 선택하세요.

VS 코드/커서 디버깅 설정

중단점을 사용하여 로컬 디버깅을 설정하려면:

VS Code 사용자 설정에 Heroku 인증 토큰을 저장합니다.
- 명령 팔레트를 엽니다(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"] } ] }
(선택 사항) TypeScript 파일에 중단점을 설정합니다.
F5를 누르거나 Run and Debug 사이드바를 사용하세요.

참고: 디버거는 실행하기 전에 자동으로 TypeScript 파일을 빌드합니다.

Heroku MCP server

Integrations