Minecraft MCP Integration

基本能力

产品定位

Minecraft MCP Integration 是一个为 Minecraft 设计的模型上下文协议（MCP）集成，旨在通过 AI 助手增强 Minecraft 的游戏体验。

核心功能

• 提供与 Minecraft 服务器的交互能力
• 支持多种游戏内操作，如移动、放置方块、攻击实体等
• 提供丰富的 MCP 资源，如机器人位置和状态

适用场景

• AI 助手与 Minecraft 世界的交互
• 自动化 Minecraft 游戏操作
• 游戏测试和开发

工具列表

• chat: 发送聊天消息到服务器
• jump: 让机器人跳跃
• moveForward: 让机器人向前移动
• moveBack: 让机器人向后移动
• turnLeft: 让机器人向左转
• turnRight: 让机器人向右转
• placeBlock: 在指定坐标放置方块
• digBlock: 在指定坐标破坏方块
• getBlockInfo: 获取指定坐标方块的信息
• selectSlot: 选择快捷栏槽位 (0-8)
• getInventory: 获取机器人背包内容
• equipItem: 按名称装备物品到指定位置
• getStatus: 获取机器人当前状态（生命值、食物、位置等）
• getNearbyEntities: 获取范围内附近的实体列表
• attack: 按名称攻击附近的实体
• useItem: 使用/激活当前持有的物品
• stopUsingItem: 停止使用/停用当前物品
• lookAt: 让机器人看向特定坐标
• followPlayer: 跟随特定玩家
• stopFollowing: 停止跟随当前目标
• goToPosition: 导航到特定坐标

常见问题解答

1. MCP 连接失败
2. 查找并终止残留的 Java 进程

3. 重启计算机如果进程终止失败

4. 服务器无法启动

5. 验证 Java 是否安装
6. 检查 server.jar 路径是否正确

7. 确保端口 25565 可用

8. 无法连接到服务器

9. 验证服务器是否正在运行
10. 确认使用 "localhost" 作为服务器地址
11. 检查防火墙设置

使用教程

使用依赖

1. Minecraft Launcher
2. Node.js 18 或更高版本
3. Claude Desktop App
4. Java 21.0.5 (推荐)

安装教程

1. 下载并设置 Minecraft 服务器
2. 从 mcversions.net/1.21 下载 Minecraft 服务器 v1.21
3. 安装 Java 21.0.5（如果尚未安装）
4. 创建专用目录（例如 ~/minecraft-server/）
5. 将下载的 server.jar 文件放入此目录

6. 记下 server.jar 文件的绝对路径

7. 安装并配置 MCP 集成 快速安装（推荐）： bash npx -y @smithery/cli install mcp-minecraft --client claude 或手动设置：

8. 导航到 ~/Library/Application Support/Claude/claude_desktop_config.json

9. 添加 MCP 服务器配置

10. 启动 Claude Desktop

11. 完成配置后启动 Claude Desktop

12. 连接到服务器

13. 打开 Minecraft Launcher
14. 安装并启动 Minecraft Java Edition v1.21
15. 点击 "Play" 并选择 "Multiplayer"
16. 点击 "Add Server"
17. 输入服务器详细信息

调试方式

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

许可证

该项目遵循 MIT 开源许可条款，请参阅 MIT 了解完整条款。