项目简介

本项目 'mcp-minecraft' 是一个 MCP (Model Context Protocol) 服务器的实现，它允许AI助手（如 Claude）通过 MCP 协议与 Minecraft 游戏服务器进行交互。通过此集成，AI 可以观察 Minecraft 世界，并控制游戏内的角色（Bot）执行各种操作，例如移动、建造、聊天等。

主要功能点

资源 (Resources): 提供 Minecraft 世界和 Bot 状态的实时数据，例如 Bot 的位置 ('minecraft://bot/location') 和连接状态 ('minecraft://bot/status')。
工具 (Tools): 允许 AI 控制 Bot 在 Minecraft 中执行各种操作，包括：
- 聊天互动 ('chat')
- 移动控制 ('jump', 'moveForward', 'moveBack', 'turnLeft', 'turnRight', 'goToPosition')
- 方块操作 ('placeBlock', 'digBlock', 'getBlockInfo')
- 物品栏管理 ('selectSlot', 'getInventory', 'equipItem', 'useItem', 'stopUsingItem')
- 实体互动 ('getNearbyEntities', 'attack', 'followPlayer', 'stopFollowing')
- 状态查询 ('getStatus')
- 视野控制 ('lookAt')

安装步骤

安装 Minecraft 服务器:
- 下载 Minecraft Java 版服务器 v1.21 版本的 'server.jar' 文件。
- 安装 Java 21.0.5 或更高版本。
- 创建一个用于存放服务器文件的目录，并将 'server.jar' 放入其中。
安装 MCP 集成:
- 推荐快速安装: 运行命令 'npx -y @smithery/cli install mcp-minecraft --client claude'，按照提示完成安装。
- 手动安装:
  - 打开 Claude Desktop 的配置文件 '~/Library/Application Support/Claude/claude_desktop_config.json'。
  - 在 'mcpServers' 中添加 'mcp-minecraft' 服务器配置（如果不存在 'mcpServers' 字段，请手动创建）。
启动 Claude Desktop: 完成配置后，启动 Claude Desktop 应用程序。
连接到 Minecraft 服务器:
- 启动 Minecraft 启动器，安装并启动 Minecraft Java 版 v1.21。
- 在 Minecraft 游戏中，选择“多人游戏”，点击“添加服务器”。
- 输入服务器信息：
  - 服务器名称: 'Minecraft Server' (可自定义)
  - 服务器地址: 'localhost:25565'
- 点击“完成”并连接到服务器。

服务器配置

MCP 客户端（如 Claude Desktop）需要以下配置信息来启动和连接 'mcp-minecraft' 服务器。将以下 JSON 配置添加到 Claude Desktop 的 'claude_desktop_config.json' 文件中的 'mcpServers' 字段下。

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

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

基本使用方法

确保 Minecraft 服务器和 'mcp-minecraft' 服务器都已启动，并且 Claude Desktop 已配置并连接到 'mcp-minecraft' 服务器。
在 Claude Desktop 中，您应该能够看到 'mcp-minecraft' 服务器已连接。
您可以通过 Claude 的对话界面，使用预定义的工具来控制 Minecraft 世界中的 Bot。例如，您可以指示 Claude "让 Bot 跳跃" 或 "让 Bot 移动到坐标 (10, 60, 20)" 等。
AI 助手会根据您的指令，调用相应的 MCP 工具，从而控制 Minecraft 中的 Bot 执行操作。
您可以通过读取 MCP 资源来获取 Minecraft 世界和 Bot 的状态信息，以便 AI 助手更好地理解游戏环境。

关键词

项目简介

主要功能点

安装步骤

服务器配置

基本使用方法

信息