minecraft-remote

🚀 Minecraft 远程控制 MCP 项目

本项目受启发于 mcp-minecraft 由 arjunkmrm 创建。原项目仅支持本地 Minecraft 服务器连接，而此新项目是从头开始创建，新增了对远程 Minecraft 服务器连接的支持。本项目可使用 MCP（模型上下文协议）控制 Minecraft 游戏。

🚀 快速开始

本项目通过 MCP 协议与 AI 助手（如 Claude）集成，借助以下操作可快速上手。

配置文件

创建或编辑 config.json 文件，添加以下内容：

{
  "minecraft_server": "play.example.com",
  "username": "player1",
  "password": "your_password"
}

示例命令

• 查询服务器状态：query_minecraft_status
• 获取当前玩家列表：get_players
• 控制玩家移动：move_player x=100 y=64 z=-200

✨ 主要特性

• 通过 AI 助手连接并控制 Minecraft 玩家
• 导航、挖掘、建造并与 Minecraft 世界互动
• 与其他玩家聊天
• 查看库存、玩家位置和服务器信息
• 高级运动控制，包括跳跃、潜行和疾跑
• 实体交互，包括攻击和跟随
• 容器使用（箱子、熔炉等）
• 物品合成与村民交易
• 详细的库存管理

📦 安装指南

快速安装（推荐）

npx -y @smithery/cli install mcp-minecraft-remote --client claude

按照 CLI 提示完成设置。

手动安装

1. 下载 Node.js 18+。
2. 安装 @smithery/cli：

   npm install -g @smithery/cli
   

3. 使用 CLI 安装项目：

   smithery install mcp-minecraft-remote --client claude
   

📚 详细文档

配置文件

创建或编辑 config.json 文件，添加以下内容：

{
  "minecraft_server": "play.example.com",
  "username": "player1",
  "password": "your_password"
}

示例命令

• 查询服务器状态：query_minecraft_status
• 获取当前玩家列表：get_players
• 控制玩家移动：move_player x=100 y=64 z=-200

🔧 技术细节

技术要求

• Node.js 18+
• 支持 MCP 的 AI 助手（如 Claude）
• Minecraft Java 版本 1.8 或更高版本

⚠️ 重要提示

此工具经过测试，确认与原版 Minecraft 1.21 兼容。其他版本或模改服务器的兼容性未经过验证。

📄 许可证

MIT