金大哥 - Minecraft MCP 详情

article

README

🚀 Minecraft MCP 集成

这是一个 Model Context Protocol (MCP) 的集成项目，旨在实现 AI 助手与 Minecraft 服务器的交互。借助此集成，AI 模型能够观察 Minecraft 世界，并通过机器人与之进行互动。

🚀 快速开始

本项目是 Model Context Protocol (MCP) 的集成，能让 AI 助手与 Minecraft 服务器进行交互，使 AI 模型可观察并通过机器人与 Minecraft 世界互动。

✨ 主要特性

机器人控制：通过 MCP 接口控制游戏中的角色。
数据交换：在游戏和 AI 之间传输实时数据。
脚本支持：使用 Node.js 编写自定义脚本来扩展功能。

📦 安装指南

先决条件

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

⚠️ 重要提示

目前仅在 macOS/Linux 上测试过，Windows 的兼容性未保证。

安装步骤

下载并设置 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。
- 将以下内容添加到文件中：
```
{
  "mcpIntegration": {
    "enabled": true,
    "serverPath": "/path/to/minecraft-server",
    "jarName": "server.jar"
  }
}
```
- 启动 Claude 桌面应用程序并启用 MCP 集成功能。
验证安装
- 确保 Java 和 Node.js 已正确安装。
- 检查 server.jar 文件是否存在且路径正确。
- 尝试启动 Minecraft 服务器以确保其正常运行。

注意事项

在首次运行时，可能需要额外的依赖项。请根据提示安装所需的软件包。
如果遇到问题，请检查日志文件以获取更多信息。

重要注意事项

使用 F3+P 快捷键：同时按下 F3 和 P。这将切换“暂停以响应失去焦点”的功能。关闭后，您可以切回 claude 桌面应用程序，并继续运行 Minecraft 而不会暂停。

焦点设置

Claude 重启时的连接问题：如果在 Minecraft 服务器运行时重启 Claude，可能会由于遗留的 Java 进程而导致下次启动 MCP 连接失败。请参见常见问题：MCP 连接失败中的解决步骤。

📚 详细文档

常见问题

1. 无法连接到服务器

确保 Minecraft 服务器正在运行。
检查您是否在使用 "localhost" 作为服务器地址。
查看防火墙设置以确保端口 25565 可用。

2. 服务器未启动

验证 Java 是否已安装。
检查 server.jar 路径是否正确。
确保端口 25565 未被占用。

3. Java 进程未终止

在 Mac/Linux 上，使用命令 jps 查找 Java 进程。
使用任务管理器（Windows）或活动监视器（Mac/Linux）强制结束进程。
如果无法手动终止，请重启计算机。

日志位置

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

📄 许可证

本项目在 MIT 许可证下开源 - 详细信息请参阅 LICENSE 文件。

🌟 贡献

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

Minecraft