butterstack-mcp

A Model Context Protocol (MCP) server for ButterStack: give an AI assistant read/write access to your game dev pipeline, tasks, builds, and asset approvals.

런타임 의존성이 없습니다. Node 내장 모듈만 사용합니다.

Install

MCP 클라이언트 설정에 다음을 추가하세요. 전역 설치가 필요 없으며, npx가 요청 시 가져옵니다:

{
  "mcpServers": {
    "butterstack": {
      "command": "npx",
      "args": ["-y", "butterstack-mcp"]
    }
  }
}

Claude Desktop

claude_desktop_config.json을 편집하고(설정 -> 개발자 -> 구성 편집) 위 블록을 mcpServers 아래에 추가한 다음 Claude Desktop을 다시 시작하세요.

Cursor

같은 블록을 프로젝트의 .cursor/mcp.json 또는 전역 Cursor MCP 설정의 mcpServers 아래에 추가하세요.

Antigravity

같은 블록을 Antigravity MCP 구성의 mcpServers 아래에 추가하세요.

Authentication

클라이언트의 MCP 서버 환경에 BUTTERSTACK_API_TOKEN을 설정하세요. 이것이 기본이자 권장되는 인증 방식입니다. 다른 것을 설치하지 않아도 단독으로 작동합니다.

{
  "mcpServers": {
    "butterstack": {
      "command": "npx",
      "args": ["-y", "butterstack-mcp"],
      "env": {
        "BUTTERSTACK_API_TOKEN": "your-token-here"
      }
    }
  }
}

ButterStack 계정 설정에서 토큰을 생성하세요.

별도로 ButterStack CLI를 설치했고 이미 butter auth login을 실행했다면, 이 서버는 디스크에 저장된 자격 증명(~/.config/butterstack/credentials.json)도 자동으로 읽어들이므로 토큰을 두 번 구성할 필요가 없습니다. 하지만 CLI는 이 패키지의 의존성이 아니며 설치가 필수도 아닙니다. BUTTERSTACK_API_TOKEN만으로 충분합니다.

Host

기본적으로 서버는 https://www.butterstack.com과 통신합니다. 자체 호스팅 또는 로컬 인스턴스를 지정하려면 BUTTERSTACK_HOST를 설정하세요:

{
  "env": {
    "BUTTERSTACK_API_TOKEN": "your-token-here",
    "BUTTERSTACK_HOST": "http://localhost:3000"
  }
}

서버는 저장된 자격 증명을 발급된 호스트가 아닌 다른 호스트로 보내지 않습니다. "Refusing to send the stored credential" 오류가 표시되면 BUTTERSTACK_HOST를 자격 증명이 발급된 호스트에 맞게 설정하거나, 지정하려는 호스트에 대한 새 자격 증명을 생성하세요.

Tools

모든 도구는 project_id를 받습니다(projects_list 제외). project_id는 숫자 프로젝트 ID 또는 프로젝트 이름을 허용합니다.

Prompts

Resources

Requirements

Node 18 이상. 이는 지원 버전 정책이지 기술적 최소 요구 사항은 아닙니다. 서버는 Node 10.9.0까지 호환되는 내장 모듈만 사용하지만, 이 패키지가 실제로 테스트된 가장 오래된 버전은 18입니다.

License

MIT