remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Allows installation of the MCP server directly from GitHub using npx, making setup easier for users.
Required as a prerequisite for running the MCP server, providing the runtime environment for the Mineflayer-based bot.

Minecraft MCP サーバー

⚠️重要な互換性に関する警告：2025年3月25日現在、Minecraft 1.21.5がリリースされました。このボットは現在Minecraft 1.21.5と互換性がありません。1.21.5をサポートするアップデートがリリースされるまで、Minecraft 1.21.4をご利用ください。

大規模言語モデルとMineflayer APIを搭載したMinecraftボット。このボットは、モデルコンテキストプロトコル（MCP）を使用して、Claudeやその他のサポートされているモデルがMinecraftキャラクターを制御できるようにします。

前提条件

Node.js
実行中の Minecraft ゲーム (以下のセットアップは、Microsoft Game Pass に含まれる Minecraft 1.21.4 Java Edition でテストされています)
クロードデスクトップ

はじめる

このボットは、モデルコンテキストプロトコル (MCP) を介して Claude Desktop で使用されるように設計されています。

Minecraftを実行する

シングルプレイヤーワールドを作成し、LANに公開します（ ESC -> Open to LAN ）。ボットはポート25565 、ホスト名localhostを使用して接続を試みます。これらのパラメータは、次のステップでclaude_desktop_config.jsonで設定できます。

MCP構成

Claude Desktopがインストールされていることを確認してください。 File -> Settings -> Developer -> Edit Configを開いてください。インストールディレクトリが開きますclaude_desktop_config.jsonという名前のファイルを見つけ、以下のコードを挿入してください。

{
  "mcpServers": {
    "minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "github:yuniko-software/minecraft-mcp-server",
        "--host",
        "localhost",
        "--port",
        "25565",
        "--username",
        "ClaudeBot"
      ]
    }
  }
}

--portおよび--hostパラメータが正しく使用されているか再度確認してください。Claude デスクトップアプリケーションを完全に再起動してください（OS トレイで閉じられているはずです）。

ランニング

Minecraft ゲームが起動していて、ワールドが LAN に公開されていることを確認してください。その後、Claude デスクトップアプリケーションを起動すると、ボットがゲームに参加します。

Claude Desktop が MCP サーバーを起動するまでには時間がかかる場合があります。サーバーが正常に起動したことを示す目印は、チャットの横に表示されるハンマーアイコンです。

アクティブなClaude Desktopチャットからボットにあらゆるコマンドを送ることができます。建物の画像をアップロードして、ボットに建ててもらうこともできます😁

プロンプトで、ボットがMinecraft内で何かを行う必要があることを忘れずに指定してください。これはMCPサーバーを起動するトリガーとなるため、許可を求められます。

Claude 3.7 Sonnetを使うと、興味深い結果が得られるかもしれません。ボットエージェントは本当に賢くなるでしょう🫡

使用例:共有されたクロードチャット

利用可能なコマンド

Minecraft サーバーに接続すると、Claude は次のコマンドを使用できます。

動き

get-position - ボットの現在の位置を取得する
move-to-position - 特定の座標に移動する
look-at - ボットに特定の座標を向けさせる
jump - ボットをジャンプさせる
move-in-direction - 一定時間、特定の方向に移動する

在庫

list-inventory - ボットのインベントリにあるすべてのアイテムを一覧表示する
find-item - 在庫内の特定のアイテムを検索する
equip-item - 特定のアイテムを装備する

ブロックインタラクション

place-block - 指定された座標にブロックを配置する
dig-block - 指定された座標でブロックを掘る
get-block-info - ブロックに関する情報を取得する
find-block - 特定のタイプの最も近いブロックを検索します

エンティティインタラクション

find-entity - 特定のタイプの最も近いエンティティを検索する

コミュニケーション

send-chat - ゲーム内でチャットメッセージを送信する

貢献

このアプリケーションはわずか2日で作成され、コードは非常にシンプルで分かりやすいです。リファクタリングのコミット、機能およびテストへの貢献、問題解決、そして議論にご協力いただければ幸いです。

改善のためのプルリクエストや未解決の課題をお気軽にご提出ください。改善が必要な箇所は以下のとおりです。

追加ドキュメント
より堅牢なエラー処理
さまざまなコンポーネントのテスト
新しい機能とコマンド

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

View all tools

Mineflayer APIを搭載したMinecraft MCPサーバー。Minecraftキャラクターをリアルタイムで操作し、AIアシスタントが建造物を構築したり、世界を探索したり、自然言語による指示を通じてゲーム環境とインタラクトしたりできるようになります。

Related Resources

Reddit Discussion about this server

mcp-minecraft