Heroku

Heroku MCP 서버는 Heroku 플랫폼과 상호작용할 수 있는 Model Context Protocol 구현체입니다. 이 서버를 통해 AI 어시스턴트가 애플리케이션 및 데이터베이스 관리, 스케일링, 배포 등 Heroku 플랫폼의 다양한 기능을 직접 제어할 수 있습니다.

특징

• Heroku CLI 통합: Heroku CLI를 기반으로 한 빠르고 효율적인 명령 실행
• REPL 모드: 지속적인 CLI 프로세스를 통한 빠른 명령 실행 및 멀티 도구 작업 최적화
• 앱 라이프사이클 관리: 배포, 스케일링, 재시작, 로그 확인 등 애플리케이션 관리 기능
• 데이터베이스 관리: Heroku Postgres 데이터베이스 작업 수행
• 애드온 관리: 다양한 Heroku 애드온 검색, 연결 및 관리
• 자연어 인터페이스: 자연어 명령을 통한 Heroku 리소스 관리

API

리소스

앱 목록

• 사용자 계정에 연결된 모든 Heroku 앱 목록

데이터베이스 정보

• Heroku Postgres 데이터베이스 상세 정보

애드온 목록

• 설치 가능한 애드온 목록 및 현재 앱에 연결된 애드온 정보

도구

list_apps

모든 Heroku 앱을 나열합니다. - 입력: - filter: 필터 옵션 (personal, collaborator, team, space) (선택 사항)

get_app_info

앱에 대한 상세 정보를 가져옵니다. - 입력: - app: 앱 이름 - include_addons: 애드온 정보 포함 여부 (기본값: true) - include_dynos: 다이노 정보 포함 여부 (기본값: true)

create_app

새 앱을 생성합니다. - 입력: - name: 앱 이름 (선택 사항) - region: 지역 (선택 사항) - team: 팀 이름 (선택 사항) - space: 스페이스 이름 (선택 사항)

restart_app

앱을 재시작합니다. - 입력: - app: 앱 이름 - dyno: 특정 다이노 이름 (선택 사항)

scale_app

앱의 다이노 수를 조정합니다. - 입력: - app: 앱 이름 - type: 다이노 타입 - quantity: 다이노 수량 - size: 다이노 크기 (선택 사항)

get_app_logs

앱 로그를 가져옵니다. - 입력: - app: 앱 이름 - lines: 가져올 로그 라인 수 (기본값: 100) - tail: 실시간 로그 스트리밍 여부 (기본값: false)

create_postgresql_addon

PostgreSQL 애드온을 생성합니다. - 입력: - app: 앱 이름 - plan: 데이터베이스 플랜 (기본값: 'hobby-dev')

execute_postgresql_query

PostgreSQL 쿼리를 실행합니다. - 입력: - app: 앱 이름 - query: SQL 쿼리 문자열 - database: 데이터베이스 URL 또는 별칭 (선택 사항)

deploy_one_off_dyno

일회성 다이노에서 코드나 명령을 실행합니다. - 입력: - app: 앱 이름 - command: 실행할 명령어 - files: 생성할 파일 목록 (선택 사항) - env: 환경 변수 (선택 사항)

사용 방법

설치 및 구성

Heroku MCP 서버는 다양한 MCP 클라이언트와 함께 사용할 수 있습니다:

Claude Desktop 설정

1. Claude Desktop 구성 파일을 엽니다:
2. macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

3. Windows: %APPDATA%/Claude/claude_desktop_config.json

4. mcpServers 객체에 Heroku 서버 설정을 추가합니다:

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

Cursor 설정

1. 설정 -> Cursor 설정 -> MCP로 이동합니다.
2. "+ Add New MCP Server" 버튼을 클릭합니다.
3. 다음 정보를 입력합니다:
4. 이름: heroku
5. 명령어: npx
6. 인수: -y @heroku/mcp-server
7. 환경 변수:
   • HEROKU_API_KEY: Heroku API 키

Windsurf 설정

1. Windsurf의 mcp_config.json 파일에 다음 설정을 추가합니다:

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

Heroku API 키 획득 방법

1. Heroku CLI에 로그인합니다:

   heroku login

2. API 키를 획득합니다:

   heroku auth:token

3. 출력된 토큰을 MCP 서버 구성의 HEROKU_API_KEY 환경 변수에 설정합니다.

활용 사례

1. 앱 라이프사이클 자동화: AI 어시스턴트를 통한 애플리케이션 배포, 스케일링, 모니터링 자동화
2. 데이터베이스 관리: Heroku Postgres 데이터베이스 생성, 쿼리, 백업 및 관리 작업 수행
3. 애드온 발견 및 통합: 적합한 애드온 검색 및 애플리케이션 연결
4. 로그 분석: 애플리케이션 로그 분석을 통한 문제 해결 및 최적화
5. 코드 배포 및 테스트: 일회성 다이노를 활용한 코드 테스트 및 배포 자동화

연결된 구성 요소

• AWS
• Azure
• PostgreSQL
• GitHub