Minecraft MCP

Minecraft MCP集成

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

Screenshot

先决条件

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

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

重要提示

1. 使用F3+P快捷键:

同时按下F3+P。这将切换“失焦时暂停”功能。一旦关闭，您可以切换到claude桌面，Minecraft将继续运行而不会暂停。

Focus Settings

1. Claude重启时的连接问题:

如果在Minecraft服务器运行时重新启动Claude，由于java进程延迟，您可能会在下次启动Claude时遇到MCP连接问题。看 故障排除：MCP连接失败 用于解决步骤。

安装步骤

1. 下载并设置Minecraft服务器

- 下载Minecraft服务器v1.21 - 如果尚未安装，请安装Java 21.0.5（其他版本未经测试） - 创建专用目录（例如。， ~/minecraft-server/) - 放置下载的 server.jar 此目录中的文件 - 记下你的绝对路径 server.jar 文件

1. 安装和配置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路径

1. 启动克劳德桌面

- 完成配置后启动Claude Desktop

1. 连接到服务器

- 打开Minecraft启动器 - 安装并启动Minecraft Java版 v1.21 - 点击“玩”并选择“多人游戏” - 点击“添加服务器” - 输入服务器详细信息： - 服务器名称： Minecraft Server - 服务器地址： localhost:25565 - 点击“完成”

特性

资源

集成暴露了这些MCP资源：

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

工具

可用的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 - 如果进程终止失败，请重新启动计算机 - 注意：最新版本应自动解决这些问题

1. 服务器无法启动

- 验证Java是否已安装 - 检查server.jar路径是否正确 - 确保端口25565可用

1. 无法连接到服务器

- 验证服务器是否正在运行（检查日志） - 确认您正在使用“localhost”作为服务器地址 - 检查防火墙设置

日志位置

• Minecraft服务器日志：检查Minecraft服务器目录
• 克劳德桌面日志： ~/Library/Logs/Claude/mcp*.log

贡献

欢迎捐款，无论大小！

许可证

此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。