/ ディレクトリ / プレイグラウンド / minecraft-mcp-server
● コミュニティ yuniko-software ⚡ 即起動

minecraft-mcp-server

作者 yuniko-software · yuniko-software/minecraft-mcp-server

Control a Minecraft bot with Claude — build structures, explore worlds, manage inventory, and interact in real-time via natural language.

minecraft-mcp-server uses the Mineflayer API to let AI assistants control a Minecraft character in real-time. Claude can navigate, build structures, manage inventory, interact with blocks and entities, smelt items, and communicate in chat. Supports Minecraft 1.21.11, connects via LAN to your singleplayer world, and works with Claude Desktop.

なぜ使うのか

主な機能

ライブデモ

実際の動作

minecraft-mcp-server-2.replay ▶ 準備完了
0/0

インストール

クライアントを選択

~/Library/Application Support/Claude/claude_desktop_config.json  · Windows: %APPDATA%\Claude\claude_desktop_config.json
{
  "mcpServers": {
    "minecraft-mcp-server-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/yuniko-software/minecraft-mcp-server"
      ]
    }
  }
}

Claude Desktop → Settings → Developer → Edit Config を開く。保存後、アプリを再起動。

~/.cursor/mcp.json · .cursor/mcp.json
{
  "mcpServers": {
    "minecraft-mcp-server-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/yuniko-software/minecraft-mcp-server"
      ]
    }
  }
}

Cursor は Claude Desktop と同じ mcpServers スキーマを使用。プロジェクト設定はグローバルより優先。

VS Code → Cline → MCP Servers → Edit
{
  "mcpServers": {
    "minecraft-mcp-server-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/yuniko-software/minecraft-mcp-server"
      ]
    }
  }
}

Cline サイドバーの MCP Servers アイコンをクリックし、"Edit Configuration" を選択。

~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "minecraft-mcp-server-2": {
      "command": "TODO",
      "args": [
        "See README: https://github.com/yuniko-software/minecraft-mcp-server"
      ]
    }
  }
}

Claude Desktop と同じ形式。Windsurf を再起動して反映。

~/.continue/config.json
{
  "mcpServers": [
    {
      "name": "minecraft-mcp-server-2",
      "command": "TODO",
      "args": [
        "See README: https://github.com/yuniko-software/minecraft-mcp-server"
      ]
    }
  ]
}

Continue はマップではなくサーバーオブジェクトの配列を使用。

~/.config/zed/settings.json
{
  "context_servers": {
    "minecraft-mcp-server-2": {
      "command": {
        "path": "TODO",
        "args": [
          "See README: https://github.com/yuniko-software/minecraft-mcp-server"
        ]
      }
    }
  }
}

context_servers に追加。保存時に Zed がホットリロード。

claude mcp add minecraft-mcp-server-2 -- TODO 'See README: https://github.com/yuniko-software/minecraft-mcp-server'

ワンライナー。claude mcp list で確認、claude mcp remove で削除。

ユースケース

実用的な使い方: minecraft-mcp-server

How to build a Minecraft structure with AI assistance

👤 Minecraft players who want AI help with building ⏱ ~15 min beginner

使うタイミング: You want to build something complex in Minecraft without placing every block manually.

前提条件
  • Minecraft Java Edition 1.21.11 — Create a singleplayer world and Open to LAN
  • minecraft-mcp-server configured — Add to Claude Desktop config with host, port, and username
フロー
  1. Describe the build
    Build a 10x10 stone house with oak wood corners, glass windows on each wall, an oak door, and a flat stone roof. Start at my current position.✓ コピーしました
    → Bot begins placing blocks systematically, reporting progress
  2. Modify the build
    Add a second floor with the same layout and a staircase connecting them.✓ コピーしました
    → Second floor built with stairs

結果: A complete structure built in Minecraft via natural language instructions.

注意点
  • Bot doesn't have required blocks in inventory — Ensure the bot has materials or switch to Creative mode for unlimited blocks

Send an AI bot to explore and gather resources in Minecraft

👤 Minecraft players who want automated resource gathering ⏱ ~20 min beginner

使うタイミング: You need resources but don't want to grind for them.

前提条件
  • Minecraft world open to LAN with bot connected — Configure and launch
フロー
  1. Explore surroundings
    Look around and tell me what biome we're in. Find the nearest cave entrance.✓ コピーしました
    → Biome info and cave location
  2. Gather resources
    Go to the cave and mine all iron ore you can find. Come back and smelt it into iron ingots.✓ コピーしました
    → Mining progress updates and smelting confirmation

結果: Resources gathered and processed automatically.

注意点
  • Bot gets stuck on complex terrain — Use fly-to for navigation over rough terrain

組み合わせ

他のMCPと組み合わせて10倍の力を

minecraft-mcp-server-2 + filesystem

Save build plans as files and load them for construction

Save this house blueprint to a file so we can build it again in another world.✓ コピーしました

ツール

このMCPが提供する機能

ツール入力呼び出すタイミングコスト
get-position none Get the bot's current position 0
move-to-position x: int, y: int, z: int Navigate to a specific position 0
place-block x: int, y: int, z: int, block_name: str Place a block at a position 0
dig-block x: int, y: int, z: int Mine/dig a block 0
list-inventory none List items in the bot's inventory 0
find-blocks block_name: str, range?: int Find nearby blocks of a type 0
send-chat message: str Send a message in game chat 0

コストと制限

運用コスト

APIクォータ
N/A — connects directly to Minecraft LAN
呼び出しあたりのトークン
100–500 tokens per action
金額
Free MCP server — requires Minecraft Java Edition ($26.95)
ヒント
Give high-level instructions ('build a house') rather than individual block placements to reduce calls.

セキュリティ

権限、シークレット、影響範囲

認証情報の保管: N/A — connects to LAN game
データ送信先: Connects to your local Minecraft LAN server only

トラブルシューティング

よくあるエラーと対処法

Bot can't connect to server

Ensure you opened the world to LAN (ESC → Open to LAN) and the port in your config matches the LAN port shown in chat.

確認: Check the Minecraft chat for 'Local game hosted on port XXXXX'
Bot disconnected

The Minecraft server may have kicked the bot for inactivity or invalid actions. Restart Claude Desktop to reconnect.

確認: Check Minecraft chat for kick messages
Can't place blocks — invalid position

The bot may be too far from the target position. Move closer first with move-to-position.

確認: Check bot position relative to target

代替案

minecraft-mcp-server 他との比較

代替案代わりに使う場面トレードオフ
Roblox Studio MCPYou want AI-assisted game development in Roblox instead of MinecraftDifferent platform and audience

その他

リソース

📖 GitHub の公式 README を読む

🐙 オープンな issue を見る

🔍 400以上のMCPサーバーとSkillsを見る