项目简介

该项目是一个 Minecraft MCP 服务器，它允许 AI 助手通过 Model Context Protocol (MCP) 与 Minecraft 游戏服务器进行交互。借助此服务器，AI 助手可以获取 Minecraft 世界的上下文信息，并控制游戏中的角色（Bot）执行各种操作。

主要功能点

资源 (Resources):
- 'minecraft://bot/location': 获取 Bot 在 Minecraft 世界中的当前位置坐标。
- 'minecraft://bot/status': 获取 Bot 的连接状态。
工具 (Tools): 提供丰富的 Minecraft 游戏操作工具，允许 AI 助手控制 Bot 在游戏中执行各种动作，例如：
- 聊天 ('chat')
- 移动 ('moveForward', 'moveBack', 'jump')
- 转向 ('turnLeft', 'turnRight')
- 方块操作 ('placeBlock', 'digBlock', 'getBlockInfo')
- 物品栏管理 ('selectSlot', 'getInventory', 'equipItem')
- 实体交互 ('getNearbyEntities', 'attack', 'followPlayer')
- 物品使用 ('useItem', 'stopUsingItem')
- 视野控制 ('lookAt', 'goToPosition')

安装步骤

下载并设置 Minecraft 服务器
- 从 mcversions.net/1.21 下载 Minecraft 服务器 v1.21 ('server.jar')。
- 确保已安装 Java 21.0.5 或更高版本。
- 创建一个目录用于存放 Minecraft 服务器文件 (例如 '~/minecraft-server/')。
- 将下载的 'server.jar' 文件放入该目录。
- 记录 'server.jar' 文件的绝对路径。

安装 MCP 集成

推荐快速安装方式:

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

按照命令行提示完成安装。

手动安装方式:

打开 Claude 桌面应用的配置文件 '~/Library/Application Support/Claude/claude_desktop_config.json'。
在 'mcpServers' 中添加以下 MCP 服务器配置：

{
  "mcpServers": {
    "mcp-minecraft": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-minecraft@latest",
        "--server-jar",
        "/absolute/path/to/minecraft-server/server.jar"  // 替换为您的 server.jar 绝对路径
      ]
    }
  }
}

注意: 请将 '/absolute/path/to/minecraft-server/server.jar' 替换为您实际的 'server.jar' 文件路径。

启动 Claude 桌面应用
- 完成配置后，启动 Claude 桌面应用。
连接到 Minecraft 服务器
- 启动 Minecraft 启动器。
- 安装并启动 Minecraft Java Edition v1.21 版本。
- 点击 "Play"，选择 "Multiplayer"。
- 点击 "Add Server"。
- 输入服务器信息：
  - Server Name: 'Minecraft Server' (自定义名称)
  - Server Address: 'localhost:25565'
- 点击 "Done"。

服务器配置

MCP 客户端（如 Claude 桌面应用）需要以下配置信息来连接到 Minecraft MCP 服务器。以下是配置示例，您需要将其添加到 MCP 客户端的配置文件中。

{
  "serverName": "mcp-minecraft",  //  服务器名称，在客户端中用于标识
  "command": "npx",  // 启动服务器的命令，这里使用 npx 运行 npm 包
  "args": [  //  启动服务器的参数列表
    "-y",   // npx 参数，自动确认安装包
    "mcp-minecraft@latest",  //  要运行的 npm 包名称和版本
    "--server-jar",  //  自定义参数，指定 Minecraft server.jar 文件路径
    "/absolute/path/to/minecraft-server/server.jar"  //  实际 Minecraft server.jar 文件的绝对路径，请替换为您的路径
  ]
}

基本使用方法

确保 Minecraft 服务器和 MCP 服务器都已成功启动。
在 MCP 客户端（如 Claude 桌面应用）中配置并连接到名为 "mcp-minecraft" 的服务器。
AI 助手即可通过 MCP 协议与 Minecraft 服务器进行交互，读取资源和调用工具来控制 Minecraft 世界中的 Bot。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息