AI导哈

Minecraft AI集成工具

一个用于Minecraft的模型上下文协议（MCP）集成，使AI助手能够与Minecraft服务器交互，观察和操作游戏世界。

  • by arjunkmrm
  • TypeScript
  • 本地部署
  • 105 星标
  • 更新于
在 GitHub 查看 arjunkmrm/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将继续运行而不会暂停。
  1. Claude重启时的连接问题: 如果在Minecraft服务器运行时重新启动Claude，由于java进程延迟，您可能会在下次启动Claude时遇到MCP连接问题。看 故障排除：MCP连接失败 用于解决步骤。

安装步骤

  1. 下载并设置Minecraft服务器

    • 下载Minecraft服务器v1.21 mcversions.net/1.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

  4. 连接到服务器

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

  2. 服务器无法启动

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

  3. 无法连接到服务器

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

日志位置

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

贡献

欢迎捐款，无论大小！

许可证

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

相关 MCP