作者 yuniko-software · yuniko-software/minecraft-mcp-server
与 Claude 一起控制 Minecraft 机器人 — 构建结构、探索世界、管理库存并通过自然语言实时交互。
minecraft-mcp-server 使用 Mineflayer API 让 AI 助手实时控制 Minecraft 角色。 克劳德可以导航、建造结构、管理库存、与方块和实体交互、熔炼物品以及在聊天中进行交流。 支持 Minecraft 1.21.11，通过 LAN 连接到您的单人游戏世界，并与 Claude Desktop 配合使用。
%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。保存后重启应用。
{
"mcpServers": {
"minecraft-mcp-server-2": {
"command": "TODO",
"args": [
"See README: https://github.com/yuniko-software/minecraft-mcp-server"
]
}
}
}Cursor 使用与 Claude Desktop 相同的 mcpServers 格式。项目级配置优先于全局。
{
"mcpServers": {
"minecraft-mcp-server-2": {
"command": "TODO",
"args": [
"See README: https://github.com/yuniko-software/minecraft-mcp-server"
]
}
}
}点击 Cline 侧栏中的 MCP Servers 图标，然后选 "Edit Configuration"。
{
"mcpServers": {
"minecraft-mcp-server-2": {
"command": "TODO",
"args": [
"See README: https://github.com/yuniko-software/minecraft-mcp-server"
]
}
}
}格式与 Claude Desktop 相同。重启 Windsurf 生效。
{
"mcpServers": [
{
"name": "minecraft-mcp-server-2",
"command": "TODO",
"args": [
"See README: https://github.com/yuniko-software/minecraft-mcp-server"
]
}
]
}Continue 使用服务器对象数组，而非映射。
{
"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 中构建一些复杂的东西，而不需要手动放置每个块。
结果： 通过自然语言指令在 Minecraft 中构建的完整结构。
何时使用： You need resources but don't want to grind for them.
结果： Resources gathered and processed automatically.
Save build plans as files and load them for construction
| 工具 | 输入参数 | 何时调用 | 成本 |
|---|---|---|---|
| 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 |
Bot can't connect to serverEnsure 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 disconnectedThe Minecraft server may have kicked the bot for inactivity or invalid actions. Restart Claude Desktop to reconnect.
Check Minecraft chat for kick messagesCan't place blocks — invalid positionThe bot may be too far from the target position. Move closer first with move-to-position.
Check bot position relative to target| 替代方案 | 何时用它替代 | 权衡 |
|---|---|---|
| Roblox Studio MCP | You want AI-assisted game development in Roblox instead of Minecraft | Different platform and audience |