← 返回目录
M

Minecraft MCP Server

社区
通过自然语言控制 Minecraft 角色的 MCP 服务器
GitHub 源仓库 ↗
★ 710 Stars 分类 · 其他 热门 源版本 240c8cec337c
37FMRS · D
可靠性
6/20
安全与权限
5/20
维护活跃度
7/20
文档质量
7/20
安装易用性
12/20

该项目为 Minecraft 提供了一个功能丰富的 MCP 服务器,通过 Mineflayer 集成,使 AI 能够实时控制角色。安装配置相对简单,但有版本限制和潜在的控制风险。

查看 FMRS 评分方法 →

这是一个基于 Mineflayer API 的 Minecraft MCP 服务器。它允许 AI 助手(如 Claude)实时控制 Minecraft 角色,使其能够建造结构、探索世界并与游戏环境交互。支持通过自然语言指令下达命令。目前支持 Minecraft 1.21.11 版本。

工具能力

get-position
获取机器人当前坐标
move-to-position
移动到指定坐标
look-at
让机器人看向指定坐标
jump
让机器人跳跃
move-in-direction
沿指定方向移动一段时间
fly-to
让机器人直接飞向指定坐标
list-inventory
列出机器人背包中的所有物品
find-item
在背包中查找特定物品
equip-item
装备指定物品
place-block
在指定坐标放置方块
dig-block
在指定坐标挖掘方块
get-block-info
获取方块信息
find-blocks
查找附近特定类型的方块
smelt-item
使用熔炉类方块冶炼物品
find-entity
查找最近的特定类型实体
send-chat
在游戏中发送聊天消息
read-chat
获取玩家最近的聊天消息
detect-gamemode
检测游戏模式

安装接入

确保已安装 Node.js >= 20.10.0 和 Git。运行 Minecraft 游戏,创建单人世界并开启局域网(ESC -> 对局域网开放)。安装 Claude Desktop,打开 文件 -> 设置 -> 开发者 -> 编辑配置。在 claude_desktop_config.json 中添加 MCP 服务器配置(见 install_config)。重启 Claude Desktop,机器人将自动加入游戏。

claude_desktop_config.json
{
  "mcpServers": {
    "minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "github:yuniko-software/minecraft-mcp-server",
        "--host",
        "localhost",
        "--port",
        "25565",
        "--username",
        "ClaudeBot"
      ]
    }
  }
}

选型与风险

适合谁

  • 希望在 Minecraft 中体验 AI 驱动的自动化玩家
  • 使用 Claude Desktop 或兼容 MCP 客户端的用户

不适合谁

  • 需要支持最新版 Minecraft 的用户(当前仅支持 1.21.11)
  • 寻求商业支持或官方维护的用户

所需权限

  • MCP 服务器需要网络访问以连接到 Minecraft 服务器
  • 需要运行 npx 命令以启动服务器
  • 需要 Minecraft 服务器开启局域网模式并开放端口(默认 25565)

风险与副作用

  • 控制 Minecraft 角色可能导致游戏内意外行为,如破坏方块或移动错误
  • 如果提供不明确的指令,AI 可能执行危险操作,需用户监督
  • 与 Minecraft 服务器的连接可能不稳定,导致机器人掉线
  • 服务器目前仅支持特定版本,升级 Minecraft 可能不兼容

常见排障

  1. 确保 Minecraft 世界已开启 LAN,且端口和主机名正确
  2. 检查 Node.js 版本是否满足要求(>= 20.10.0)
  3. 完全退出并重启 Claude Desktop,确保 MCP 服务器正确加载
  4. 查看 Claude Desktop 日志以获取错误信息

使用场景

让 AI 助手在 Minecraft 中根据指令建造建筑
让 AI 助手在游戏中探索世界并收集资源
通过自然语言与游戏内玩家交互

支持客户端

Claude Desktop完整支持