bind-alias-mcp

BindAlias MCP

BindAlias Minecraft MOD 用の MCP ブリッジです。AI エージェントが Minecraft を操作できます。ゲーム状態の照会、スクリーンショットの撮影、エイリアスの実行、レシピの管理、メモの読み書き、セーブデータごとのエージェント設定の編集に対応しています。

前提条件

• BindAlias MOD を導入した Minecraft
• MOD の HTTP API が有効になっていること（デフォルトでは 127.0.0.1:25575 で待ち受け、自動的に代替ポートを使用します）

Zed にインストールする

settings.json に追加します。

{
  "context_servers": {
    "bind-alias": {
      "command": {
        "path": "npx",
        "args": ["bind-alias-mcp"]
      }
    }
  }
}

ローカルのチェックアウトを使う場合：

{
  "context_servers": {
    "bind-alias": {
      "command": {
        "path": "node",
        "args": ["path/to/BindAlias-MCP/mcp_server.js"]
      }
    }
  }
}

デフォルト以外の MOD ポートに合わせるには、--port N を使用します。

"args": ["path/to/BindAlias-MCP/mcp_server.js", "--port", "25576"]

Zed は起動時に MCP サーバーを起動します。新しいサーバーを読み込むには、編集後に Zed を再読み込みしてください（zed-reload）。

CLI からインストールする

npx bind-alias-mcp
# or globally
npm install -g bind-alias-mcp

このサーバーは stdio で MCP を通信します。任意の MCP クライアントからこのサーバーを指定してください。

ツール

ツール	機能
getFullState	ゲーム状態の全スナップショット。画面、ワールド、ディメンション、プレイヤーの位置と回転、体力、ホットバー、インベントリ、ステータス効果、近くにいるプレイヤー、さらに取得済みのチャット／MOD／サウンド／レシピのメッセージを含みます
getScreenshot	スクリーンショットを撮影し、標準の状態エンベロープとともに Base64 PNG として返します
runAlias	エイリアスを連続して実行します。オプションの nap（クライアントのティック数）を指定すると、ゲームを動作させたまま応答を遅らせます。
defineAlias	実行時に新しいエイリアスを定義します（ワールド内にいる必要があります）。
readCFG	セーブデータごとのエージェント設定（saves/<save>/bind-alias/agent.cfg）を読み取ります。シングルプレイヤーのワールド内でのみ使用できます。
writeCFG	セーブデータごとのエージェント設定を上書きして再読み込みします。シングルプレイヤーのワールド内でのみ使用できます。
readNotes	セーブデータごとのエージェントディレクトリ（saves/<save>/bind-alias/）からファイルを読み取ります。ファイル名のみ指定でき、パスは指定できません。
writeNotes	セーブデータごとのエージェントディレクトリにファイルを書き込みます。ファイル名のみ指定でき、パスは指定できません。
listRecipes	ロック解除済みのレシピを一覧表示します（差分またはクエリによる検索）。レシピブック画面（インベントリ、作業台、かまどなど）が開いている場合のみ使用できます。

ツールの説明はワイヤープロトコルのみを対象としています。エイリアスの完全なリファレンスについては、MOD のドキュメントとシステムプロンプトパッチを参照してください。

エージェントのシステムプロンプトパッチ

このサーバーが公開するツールの説明は、ワイヤープロトコル、つまりツール自体が知っておく必要のある固定情報のみを対象としています。ゲームプレイに関する知識（エイリアスの全カタログ、画面、変数、ワールドごとの cfg の仕様）は MOD やワールドによって変わるため、柔軟に適用できるパッチに分けてあります。

• プロジェクトの RULE.md に追加するパッチ — エージェントのシステムプロンプト／プロジェクトルール（例：Zed の AGENTS.md）に貼り付け、ゲームの操作方法を教えてください。

関連項目

• BindAlias MOD — このサーバーがブリッジする Minecraft MOD
• MCP Registry — io.github.Prohect/bind-alias-mcp として登録されています