minecraft-mcp-server MCP — 使用场景, 安装 & 实时演示

为什么要用

核心特性

Real-time Minecraft character control via natural language
Build structures from descriptions or images
Movement, flight, inventory management, and block interaction
Entity detection and interaction
In-game chat reading and sending

实时演示

实际使用效果

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

步骤

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
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

步骤

Explore surroundings

Look around and tell me what biome we're in. Find the nearest cave entrance.✓ 已复制

→ Biome info and cave location
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 搭配，撬动十倍杠杆

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
move-to-position	x: int, y: int, z: int	Navigate to a specific position
place-block	x: int, y: int, z: int, block_name: str	Place a block at a position
dig-block	x: int, y: int, z: int	Mine/dig a block
list-inventory	none	List items in the bot's inventory
find-blocks	block_name: str, range?: int	Find nearby blocks of a type
send-chat	message: str	Send a message in game chat

成本与限制

运行它的成本

API 配额: N/A — connects directly to Minecraft LAN
每次调用 Token 数: 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 MCP	You want AI-assisted game development in Roblox instead of Minecraft	Different platform and audience

minecraft-mcp-server

为什么要用

核心特性

实时演示

实际使用效果

安装

选择你的客户端

使用场景

实战用法： minecraft-mcp-server

How to build a Minecraft structure with AI assistance

前置条件

步骤

注意事项

Send an AI bot to explore and gather resources in Minecraft

前置条件

步骤

注意事项

组合

与其他 MCP 搭配，撬动十倍杠杆

工具

此 MCP 暴露的能力

成本与限制

运行它的成本

安全

权限、密钥、影响范围

故障排查

常见错误与修复

替代方案

minecraft-mcp-server 对比其他方案

更多

资源