mcp-minecraft

Minecraft MCP 集成

Minecraft 的模型上下文协议 (MCP) 集成，使 AI 助手能够与 Minecraft 服务器交互。此集成允许 AI 模型通过机器人观察 Minecraft 世界并与之交互。

先决条件

1. Minecraft启动器
2. Node.js 18 或更高版本
3. 克劳德桌面应用程序
4. Java 21.0.5（推荐）

⚠️ 注意：目前仅在 macOS/Linux 上测试。不保证 Windows 兼容性。

重要提示

1. 使用 F3+P 快捷键：同时按下 F3 + P。这将切换“失去焦点时暂停”功能。关闭后，您可以切换到 Claude 桌面，Minecraft 将继续运行而不会暂停。

2. 重启 Claude 时的连接问题：如果您在 Minecraft 服务器运行期间重启 Claude，则下次启动 Claude 时可能会遇到 MCP 连接问题，这是由于 Java 进程延迟所致。请参阅故障排除：MCP 连接失败，了解解决步骤。

安装步骤

1. 下载并设置 Minecraft 服务器
   • 从mcversions.net/1.21下载 Minecraft 服务器 v1.21
   • 如果尚未安装，请安装 Java 21.0.5（其他版本未经测试）
   • 创建专用目录（例如~/minecraft-server/ ）
   • 将下载的server.jar文件放在此目录中
   • 记下server.jar文件的绝对路径
2. 安装和配置 MCP 集成快速安装（推荐）：
   npx -y @smithery/cli install mcp-minecraft --client claude
   按照 CLI 提示完成设置。或手动设置：
   • 导航到~/Library/Application Support/Claude/claude_desktop_config.json
   • 添加 MCP 服务器配置：
   { "mcpServers": { "mcp-minecraft": { "command": "npx", "args": [ "-y", "mcp-minecraft@latest", "--server-jar", "/absolute/path/to/minecraft-server/server.jar" ] } } }

   ⚠️ 将/absolute/path/to/minecraft-server/server.jar替换为你实际的 server.jar 路径

3. 启动 Claude Desktop
   • 完成配置后启动Claude Desktop
4. 连接到服务器
   • 打开 Minecraft 启动器
   • 安装并启动 Minecraft Java 版v1.21
   • 点击“播放”并选择“多人游戏”
   • 点击“添加服务器”
   • 输入服务器详细信息：
     • 服务器名称： Minecraft Server
     • 服务器地址： localhost:25565
   • 点击“完成”

特征

资源

集成公开了以下 MCP 资源：

• minecraft://bot/location - 机器人当前在世界上的位置
• minecraft://bot/status - 机器人连接状态

工具

可用的 MCP 工具：

• chat - 向服务器发送聊天消息
• jump - 让机器人跳跃
• moveForward - 让机器人向前移动
• moveBack - 使机器人向后移动
• turnLeft - 让机器人左转
• turnRight - 让机器人右转
• placeBlock - 在指定坐标处放置一个块
• digBlock - 在指定坐标处破坏一个块
• getBlockInfo - 获取指定坐标处的块的信息
• selectSlot - 选择快捷栏插槽 (0-8)
• getInventory - 获取机器人库存的内容
• equipItem - 按名称将物品装备到指定目的地
• getStatus - 获取机器人的当前状态（健康、食物、位置等）
• getNearbyEntities - 获取范围内的附近实体列表
• attack - 通过名字攻击附近的实体
• useItem - 使用/激活当前持有的物品
• stopUsingItem - 停止使用/停用当前项目
• lookAt - 让机器人查看特定坐标
• followPlayer - 关注特定玩家
• stopFollowing - 停止跟随当前目标
• goToPosition导航到特定坐标

技术细节

• 服务器以离线模式运行以进行本地开发
• 默认内存分配：2GB
• 默认端口：25565
• 机器人用户名：MCPBot

故障排除

常见问题

1. MCP 连接失败
   • 查找残留的 Java 进程
   • 手动终止它们：
     • Windows：使用任务管理器（未经测试）
     • Mac/Linux：
       • 转到“活动监视器”并“强制退出”java
   • 如果进程终止失败，请重新启动计算机
   • 注意：最新版本应该会自动解决这些问题
2. 服务器无法启动
   • 验证 Java 是否已安装
   • 检查server.jar路径是否正确
   • 确保端口 25565 可用
3. 无法连接到服务器
   • 验证服务器是否正在运行（检查日志）
   • 确认您使用“localhost”作为服务器地址
   • 检查防火墙设置

日志位置

• Minecraft 服务器日志：检查 minecraft-server 目录
• Claude Desktop 日志： ~/Library/Logs/Claude/mcp*.log

贡献

欢迎任何大小贡献！

执照

该项目根据 MIT 许可证获得许可 - 有关详细信息，请参阅LICENSE文件。