关键词

Minecraft机器人AI代理游戏控制自动化JSON-RPCMineflayer

使用说明

项目简介

MCPMC (Minecraft Model Context Protocol) 是一个允许AI代理与Minecraft游戏互动的MCP服务器。它利用Mineflayer库来控制Minecraft机器人，并通过标准化的模型上下文协议（MCP）接口暴露诸如导航、方块操作和物品栏管理等功能。这使得AI能够轻松控制和理解Minecraft环境。

主要功能点

  • MCP 兼容: 完全兼容模型上下文协议，实现与AI代理的无缝集成。
  • Minecraft 控制: 使用Mineflayer库实现可靠且功能丰富的Minecraft机器人控制。
  • 游戏互动: 支持广泛的游戏操作，包括导航、方块操作、物品栏管理等。
  • 实时数据: 通过资源提供实时游戏状态监控。
  • 类型安全API: 使用TypeScript开发，提供健壮且易于维护的API。

安装步骤

  1. 前提条件: 确保已安装 Node.js (>= 18) 和 npm, yarn, 或 bun 其中之一的包管理器。
  2. 安装包: 选择以下命令之一安装 MCPMC: 
    npm install @gerred/mcpmc
    yarn add @gerred/mcpmc
    bun add @gerred/mcpmc

服务器配置

为了在MCP客户端中使用MCPMC，您需要配置客户端以连接到此服务器。以下是MCP客户端的JSON格式配置示例：

{
  "serverName": "Minecraft MCP Server",
  "command": "mcpmc",
  "args": [],
  "description": "用于控制Minecraft机器人的MCP服务器。通过命令行参数连接到指定的Minecraft服务器。",
  "transport": "stdio"
}
  • 'serverName': 此服务器配置的用户友好名称。
  • 'command': 用于启动MCP服务器的可执行命令。 'mcpmc' 假设 '@gerred/mcpmc' 包已全局安装或在您的项目的 'node_modules/.bin' 目录中。
  • 'args': 传递给 'mcpmc' 命令的命令行参数数组。 基础用法目前不需要参数，但如果需要，可以使用 '--host'、'--port' 和 '--username'。
  • 'description': 服务器的简短描述。
  • 'transport': 指定通信协议。 'stdio' 指示通过标准输入/输出进行通信。

基本使用方法

  1. 启动服务器: 打开终端并运行命令以启动MCP服务器： 
    mcpmc
    此命令将启动MCP服务器，服务器将连接到默认的Minecraft服务器 (localhost:25565)，用户名为 "Claude"。
  2. 使用MCP客户端连接: 使用上面提供的JSON配置来配置您的MCP客户端。客户端将通过标准输入/输出与MCPMC服务器通信。
  3. 与Minecraft互动: 您的AI代理现在可以通过MCP客户端向MCPMC服务器发送请求，以控制Minecraft机器人、执行工具和访问游戏资源。

信息

分类

AI与计算

访问项目