Minecraft MCP 集成

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

先决条件

1. Minecraft启动器
2. Node.js 18或更高版本
3. Claude桌面应用
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桌面

   • 在完成配置后启动Claude桌面

4. 连接到服务器

   • 打开Minecraft启动器
   • 安装并启动Minecraft Java版v1.21
   • 点击“玩”并选择“多人游戏”
   • 点击“添加服务器”
   • 输入服务器详情：
     • 服务器名称：Minecraft服务器
     • 服务器地址：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桌面日志：~/Library/Logs/Claude/mcp*.log

贡献

无论大小，我们都欢迎贡献！

许可证

本项目采用MIT许可证 - 详情请参阅LICENSE文件。