MineMCP

插件

· 作者 Axeno

一个连接 AI 代理与 Minecraft 的 MCP 服务器实现。

0 本站下载 0 关注 更新于 9 个月前

最新 0.0.1 · 1.21.11 · Paper

一键开服(送7天)

MineMCP

一个 Minecraft Paper 插件,实现了 Model Context Protocol (MCP) 服务器,使 AI 代理能够通过 HTTP 控制和监控 Minecraft 1.21 服务器。

?️ 可用工具

世界操作

  • pose_block - 在指定坐标放置方块
  • break_block - 在指定坐标破坏方块
  • fill_block - 用方块填充区域

命令执行

  • execute_command - 执行任意 Minecraft 命令并捕获输出

文件系统

  • read_file - 读取服务器上的文本文件
  • write_file - 将文本写入服务器
  • read_file_base64 - 以 Base64 格式读取二进制文件
  • write_file_base64 - 从 Base64 写入二进制文件
  • list_directory - 列出目录内容

服务器信息

  • list_plugins - 获取所有已安装的插件
  • get_logs - 检索最近的服务器日志
  • get_online_players - 列出所有在线玩家
  • get_player - 获取特定玩家的详细信息(生命值、物品栏、位置、效果等)

? 要求

  • Java 21 或更高版本
  • Minecraft 1.21 服务器
  • Paper 或 Purpur 服务器软件(Spigot 可能可用,但未官方支持)

? 安装

下载预构建 JAR

  1. 从 Releases 页面下载最新版本
  2. 将 MineMCP-1.0.0-all.jar 放入服务器的 plugins/ 文件夹
  3. 启动/重启服务器
  4. 在 plugins/MineMCP/config.yml 中配置令牌

⚙️ 配置

首次运行后,编辑 plugins/MineMCP/config.yml:

server:
  port: 3000
  token: "your-secret-token-here"  # 请更改为安全的随机令牌!

重要提示:请务必更改默认令牌以确保安全!

生成安全令牌

# Linux/macOS
openssl rand -hex 32

# 或使用任何密码生成器创建强令牌

? 用法

启动服务器

  1. 启动安装了 MineMCP 的 Minecraft 服务器
  2. MCP 服务器将在端口 3000 上自动启动(可配置)
  3. 检查控制台是否显示:[MineMCP] MCP server started on port 3000

使用 MCP 客户端连接

使用带有 MCP 扩展的 VS Code

在项目中的 .vscode/mcp.json 创建或编辑文件:

{
  "mcpServers": {
    "minecraft": {
      "url": "http://localhost:3000/sse?token=your-secret-token-here"
    }
  }
}

? API 示例

执行命令

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "execute_command",
    "arguments": {
      "command": "time set day"
    }
  }
}

放置方块

{
  "jsonrpc": "2.0",
  "id": 2,
  "method": "tools/call",
  "params": {
    "name": "pose_block",
    "arguments": {
      "world": "world",
      "x": 100,
      "y": 64,
      "z": 200,
      "material": "DIAMOND_BLOCK"
    }
  }
}

获取玩家信息

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "get_player",
    "arguments": {
      "player": "PlayerName",
      ...
    }
  }
}

? 安全注意事项

  1. 令牌保护:切勿将令牌提交到版本控制系统
  2. 网络安全:默认情况下,服务器绑定到 0.0.0.0(所有接口)
  3. 防火墙规则:限制端口 3000 仅允许受信任的 IP 访问
  4. 文件系统访问:工具可以访问整个服务器目录——请谨慎使用

? 贡献

欢迎贡献!请遵循以下步骤:

  1. Fork 仓库
  2. 创建功能分支 (git checkout -b feature/amazing-feature)
  3. 提交更改 (git commit -m 'Add amazing feature')
  4. 推送到分支 (git push origin feature/amazing-feature)
  5. 打开 Pull Request

添加新工具

  1. 在 src/main/java/me/axeno/minemcp/tools/impl/ 中创建继承自 McpTool 的新类
  2. 实现所需的方法 (getSchema() 和 execute())
  3. 在 ToolHandler.java 构造函数中注册工具

示例:

public class MyTool extends McpTool {
    public MyTool() {
        super("my_tool", "Description of my tool");
    }

    @Override
    public ObjectNode getSchema() {
        ObjectNode schema = mapper.createObjectNode();
        schema.put("type", "object");
        // 定义你的模式...
        return schema;
    }

    @Override
    public ObjectNode execute(JsonNode args) throws Exception {
        CompletableFuture<String> future = new CompletableFuture<>();
        
        Bukkit.getScheduler().runTask(MineMCP.getInstance(), () -> {
            try {
                // 在这里进行 Bukkit 操作
                future.complete("Success!");
            } catch (Exception e) {
                future.completeExceptionally(e);
            }
        });
        
        String result = future.get(10, TimeUnit.SECONDS);
        return createTextResult(result);
    }
}

? 许可证

本项目采用 MIT 许可证授权 - 详情请参阅 LICENSE 文件。

? 支持

  • 问题反馈: GitHub Issues

由 ❤️ 为 Minecraft 和 AI 社区打造

你是这个资源的作者?登录后可认领此资源。

评论 0

0.0
暂无评分
5 星
0
4 星
0
3 星
0
2 星
0
1 星
0
我的评分

登录后参与评分

还没有评论,来抢沙发吧

评论配图

相似资源