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文件。