Minecraft MCP集成
Minecraft的模型上下文协议（MCP）集成，使AI助手能够与Minecraft服务器进行交互。这种集成允许AI模型通过机器人观察Minecraft世界并与之交互。
先决条件
- Minecraft启动器
- Node.js 18或更高版本
- 克劳德桌面应用程序
- Java 21.0.5（推荐）
⚠️ 注意：目前仅在macOS/Linux上测试。不保证Windows兼容性。
重要提示
- 使用F3+P快捷键:
同时按下F3+P。这将切换“失焦时暂停”功能。一旦关闭，您可以切换到claude桌面，Minecraft将继续运行而不会暂停。
- Claude重启时的连接问题:
如果在Minecraft服务器运行时重新启动Claude，由于java进程延迟，您可能会在下次启动Claude时遇到MCP连接问题。看 故障排除：MCP连接失败 用于解决步骤。
安装步骤
- 下载并设置Minecraft服务器
- 下载Minecraft服务器v1.21 - 如果尚未安装，请安装Java 21.0.5（其他版本未经测试） - 创建专用目录（例如。， ~/minecraft-server/) - 放置下载的 server.jar 此目录中的文件 - 记下你的绝对路径 server.jar 文件
- 安装和配置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路径
- 启动克劳德桌面
- 完成配置后启动Claude Desktop
- 连接到服务器
- 打开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
故障排除
常见问题
- MCP连接失败
- 寻找挥之不去的Java进程 - 手动终止它们： - Windows：使用任务管理器（未测试） - Mac/Linux： - 转到“活动监视器”和“强制退出”java - 如果进程终止失败，请重新启动计算机 - 注意：最新版本应自动解决这些问题
- 服务器无法启动
- 验证Java是否已安装 - 检查server.jar路径是否正确 - 确保端口25565可用
- 无法连接到服务器
- 验证服务器是否正在运行（检查日志） - 确认您正在使用“localhost”作为服务器地址 - 检查防火墙设置
日志位置
- Minecraft服务器日志：检查Minecraft服务器目录
- 克劳德桌面日志：
~/Library/Logs/Claude/mcp*.log
贡献
欢迎捐款，无论大小！
许可证
此项目根据MIT许可证获得许可-请参阅 许可证 文件以获取详细信息。
