Minecraft MCP Server
2025.04.15
39
TypeScriptMinecraft 机器人游戏自动化娱乐功能
Minecraft MCP Server 是一个基于大型语言模型和 Mineflayer API 的 Minecraft 机器人，通过 Model Context Protocol (MCP) 实现 Claude 和其他支持模型控制 Minecraft 角色的功能。该机器人可以执行各种游戏内操作，如移动、物品管理、方块交互等，并支持通过 Claude Desktop 进行交互。
View on GitHub
Overview
基本能力
产品定位
Minecraft MCP Server 是一个用于控制 Minecraft 游戏角色的机器人服务，通过 MCP 协议与 Claude 等大型语言模型集成，实现智能化的游戏操作。
核心功能
- 移动控制：获取当前位置、移动到指定坐标、跳跃、朝特定方向移动等。
- 物品管理：列出物品、查找物品、装备物品等。
- 方块交互：放置方块、挖掘方块、获取方块信息、查找特定方块等。
- 实体交互：查找最近的特定类型实体。
- 通信功能：发送游戏内聊天消息。
适用场景
- 自动化 Minecraft 游戏操作。
- 通过自然语言指令控制游戏角色。
- 上传建筑图片并让机器人自动建造。
工具列表
- Claude Desktop：用于与 MCP 服务器交互的桌面应用程序。
- Mineflayer API：用于控制 Minecraft 角色的底层 API。
常见问题解答
- 兼容性问题：当前不支持 Minecraft 1.21.5，请使用 1.21.4 版本。
- 连接问题：确保 Minecraft 游戏已开启并开放到 LAN，且端口和主机名配置正确。
- 启动问题：启动后需等待 MCP 服务器完全启动，标志是聊天旁边出现锤子图标。
使用教程
使用依赖
- Node.js：确保已安装 Node.js。
- Minecraft 游戏：运行 Minecraft 1.21.4 Java Edition。
- Claude Desktop：确保已安装 Claude Desktop。
安装教程
- 创建单人世界并开放到 LAN（
ESC -> Open to LAN）。 - 打开 Claude Desktop 的配置文件
claude_desktop_config.json，插入以下代码：
{
"mcpServers": {
"minecraft": {
"command": "npx",
"args": [
"-y",
"github:yuniko-software/minecraft-mcp-server",
"--host",
"localhost",
"--port",
"25565",
"--username",
"ClaudeBot"
]
}
}
}
- 重启 Claude Desktop 应用程序。
调试方式
- 确保 Minecraft 游戏正在运行且世界已开放到 LAN。
- 启动 Claude Desktop 应用程序，机器人应加入游戏。
- 检查聊天旁边是否出现锤子图标，确认 MCP 服务器已启动。
- 通过 Claude Desktop 聊天发送指令控制机器人。