/ الدليل / الملعب / minecraft-mcp-server
← كل الخوادم ↗ GitHub
● مجتمع 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 نفس مخطط mcpServers مثل Claude Desktop. إعدادات المشروع أولى من الإعدادات العامة.

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

انقر على أيقونة MCP Servers في شريط Cline الجانبي، ثم "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 أخرى لتحقيق نتائج x10

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

المزيد

الموارد

📖 اقرأ ملف README الرسمي على GitHub

🐙 تصفح القضايا المفتوحة

🔍 تصفح أكثر من 400 خادم MCP و Skills