butterstack-mcp

ButterStack 用の Model Context Protocol (MCP) サーバー: AI アシスタントにゲーム開発パイプライン、タスク、ビルド、アセット承認への読み書きアクセスを提供します。

ランタイム依存関係ゼロ。Node 組み込みのみ。

インストール

これを MCP クライアントの設定に追加してください。グローバルインストールは不要で、npx が必要に応じて取得します:

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

Claude Desktop

claude_desktop_config.json を編集し (Settings -> Developer -> Edit Config)、上記のブロックを mcpServers の下に追加して、Claude Desktop を再起動します。

Cursor

プロジェクト内の .cursor/mcp.json、または Cursor のグローバル MCP 設定の mcpServers の下に同じブロックを追加します。

Antigravity

Antigravity の MCP 設定の mcpServers の下に同じブロックを追加します。

認証

クライアントの 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 だけで十分です。

ホスト

デフォルトではサーバーは 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 を認証情報が発行されたホストに一致させるか、接続先ホスト用に新しい認証情報を生成してください。

ツール

すべてのツールは project_id を受け取ります (projects_list を除く)。数値のプロジェクト ID またはプロジェクト名のどちらも受け付けます。

プロンプト

リソース

要件

Node 18 以降。これはサポート対象バージョンの方針であり、技術的な下限ではありません。サーバーは Node 10.9.0 まで遡って互換性のある組み込みのみを使用しますが、18 がこのパッケージが実際にテストされている最も古いバージョンです。

ライセンス

MIT