简介

允许AI模型通过一个机器人观察和与Minecraft世界互动。

简介

允许AI模型通过一个机器人观察和与Minecraft世界互动。

Minecraft MCP 集成

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

前提条件

Minecraft 启动器
Node.js 18 或更高版本
Claude 桌面应用程序
Java 21.0.5（推荐）

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

重要提示

使用 F3+P 快捷键：同时按下 F3 + P。这将切换“失去焦点时暂停”功能。关闭后，您可以切换到 Claude 桌面应用，而 Minecraft 将继续运行而不暂停。
Claude 重启时的连接问题：如果在 Minecraft 服务器运行时重新启动 Claude，您可能会在下一次启动 Claude 时遇到 MCP 连接问题，这是由于残留的 Java 进程导致的。请参阅故障排除：MCP 连接失败以获取解决步骤。

安装步骤

下载并设置 Minecraft 服务器
- 从 mcversions.net/1.21 下载 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 桌面应用
- 完成配置后启动 Claude 桌面应用
连接到服务器
- 打开 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

故障排除

常见问题

MCP 连接失败
- 查找残留的 Java 进程
- 手动终止它们：
  - Windows：使用任务管理器（未测试）
  - Mac/Linux：
    - 进入“活动监视器”并“强制退出”Java
- 如果进程终止失败，请重启计算机
- 注意：最新版本应该能够自动解决这些问题
服务器无法启动
- 验证是否已安装 Java
- 检查 server.jar 的路径是否正确
- 确保 25565 端口可用
无法连接到服务器
- 验证服务器是否正在运行（检查日志）
- 确认您使用的服务器地址是“localhost”
- 检查防火墙设置

日志位置

Minecraft 服务器日志：检查 minecraft-server 目录
Claude Desktop 日志：~/Library/Logs/Claude/mcp*.log

贡献

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

许可证

本项目根据 MIT 许可证发布 - 详情请参阅 LICENSE 文件。

服务配置

[{'mcpServers': {'mcp-minecraft': {'args': ['-y', 'mcp-minecraft@latest', '--server-jar', '/absolute/path/to/minecraft-server/server.jar'], 'command': 'npx'}}}]

来源

来源：github
链接：https://github.com/arjunkmrm/mcp-minecraft

Minecraft AI助手

简介

简介