← 返回目录

Minecraft MCP Server

社区

通过自然语言控制 Minecraft 角色的 MCP 服务器

查看安装方法 ↓ 横向对比 GitHub 源仓库 ↗

分类: 其他第 201 / 230
Stars: ★ 777 热门
传输方式: stdio（本地进程）
运行环境: Node.js 20.10.0+
凭据: 无需凭据
许可证: Apache-2.0
最近提交: 6 个月前 ⚠
工具数: 18

37FMRS · D

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

最强项 · 安装易用性 12/20 最弱项 · 安全与权限 5/20

可靠性

6/20

安全与权限

5/20

维护活跃度

7/20

文档质量

7/20

安装易用性

12/20

查看各项评分依据

可靠性 6/20: 仅依据 README：描述了通过 npx/github 启动并连接 Minecraft 的流程，列出了移动、建造、聊天等工具；但未提供源码、测试或 CI workflow 文件，无法证实 MCP 握手、工具列表与真实行为一致，也缺少错误处理与边界说明。已按静态审查要求扣分（不确定性只降不升），故低于 10 的乐观基线。
安全与权限 5/20: 未发现恶意或泄露凭据的迹象，README 示例未包含真实令牌；但仓库没有安全说明、服务器端权限/确认机制、数据边界或网络范围描述。README 提到的“请求权限”属客户端行为，不能视为服务端的最小权限或确认设计；风险可见性不足，故给低分而非触红线。
维护活跃度 7/20: 仓库未归档，使用 Apache-2.0 许可，README 有 CI/最新版本徽标并欢迎贡献；但缺少提交历史、发布明细、依赖更新、issue 响应和安全响应渠道的可验证证据，徽标与文本本身不可信，故只能给“活跃但有治理缺口”的中低分。
文档质量 7/20: README 提供安装前置条件、Claude Desktop 配置示例、命令列表和贡献链接；但工具缺少参数/返回结构说明，没有身份认证、使用限制、成本、故障排查或可验证的测试证据。文档可用但假设和缺口明显。
安装易用性 12/20: README 给出了从运行 Minecraft、开放 LAN 到编辑 claude_desktop_config.json 的清晰步骤，并有 npx 启动参数示例和 Node/Minecraft 版本说明，主流客户端配置路径明确；但无 CI/测试等可执行证据证明该配置能稳定工作，平台兼容性说明有限，因此按静态校准不超过 15，并因不确定而设置为低于示例分。

静态评测 · 未实际运行收录于 2026-08-07

查看 FMRS 评分方法 →

选型与风险

能访问什么访问网络

适合谁

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

不适合谁

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

所需权限

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

风险与副作用

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

安装接入

准备工作

运行环境：Node.js 20.10.0+

确保已安装 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"
      ]
    }
  }
}

以 Claude Desktop 为例。其他客户端的配置文件位置或字段可能不同（如 VS Code 使用 servers 字段），可用下方配置生成器转换。

.vscode/mcp.json

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

写入项目的 .vscode/mcp.json（VS Code 使用 servers 字段）。

Terminal

claude mcp add minecraft -- npx -y github:yuniko-software/minecraft-mcp-server --host localhost --port 25565 --username ClaudeBot

在终端运行；先把 <…> 占位符换成你自己的值。

生成并校验客户端配置

验证是否装好

启动已开启 LAN 的 Minecraft 世界后重启 Claude Desktop，如果服务器成功启动，机器人 ClaudeBot 应加入游戏，在客户端工具列表中应能看到 get-position、list-inventory 等工具，让机器人报告位置即可确认连接。

常见排障

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

试试这样问

连接成功后，可以直接对 AI 助手这样说：

获取机器人当前的位置坐标
在坐标 (100, 64, 200) 附近找到最近的钻石矿石并挖掉它
把机器人移动到村庄入口，然后向周围玩家发送一条聊天消息说你好
查看背包里有哪些物品，并装备那把铁镐

工具能力 18

get-position 只读

获取机器人当前坐标

move-to-position 写入

移动到指定坐标

look-at 写入

让机器人看向指定坐标

jump 写入

让机器人跳跃

move-in-direction 写入

沿指定方向移动一段时间

fly-to 写入

让机器人直接飞向指定坐标

list-inventory 只读

列出机器人背包中的所有物品

find-item 只读

在背包中查找特定物品

展开其余 10 个工具

equip-item 写入

装备指定物品

place-block 写入

在指定坐标放置方块

dig-block 破坏性

在指定坐标挖掘方块

get-block-info 只读

获取方块信息

find-blocks 只读

查找附近特定类型的方块

smelt-item 写入

使用熔炉类方块冶炼物品

find-entity 只读

查找最近的特定类型实体

send-chat 写入

在游戏中发送聊天消息

read-chat 只读

获取玩家最近的聊天消息

detect-gamemode 只读

检测游戏模式

使用场景

让 AI 助手在 Minecraft 中根据指令建造建筑

让 AI 助手在游戏中探索世界并收集资源

通过自然语言与游戏内玩家交互

支持客户端

Claude Desktop

依据项目文档列出，未经本站实测。

详细介绍

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