AI导哈

Minecraft RCON服务器连接工具

一个通过RCON协议连接AI代理与Minecraft服务器的工具，支持命令执行、日志捕获、数据库查询和插件健康检查。

  • by MinecraftCodeFoundary
  • Python
  • 本地部署
  • 12 星标
  • 更新于
在 GitHub 查看 Hareidus/Minecraft-MCP-Server

使用说明

⛏️ Minecraft RCON MCP服务器

一 MCP（模型上下文协议） 通过RCON将AI代理连接到Minecraft服务器的服务器。执行命令、监控日志、查询数据库和检查插件健康状况——所有这些都可以通过您的AI编码助手完成。

在真实的人工智能辅助Minecraft插件开发过程中构建和战斗测试。

特性

  • RCON命令执行 --运行任何服务器命令，并在失败时自动重新连接
  • 命令+日志捕获 --执行命令并捕获随后的服务器日志输出（对于插件调试来说是独特而强大的）
  • 服务器日志读取 --跟踪最新的服务器日志
  • 过滤日志监控 --通过可配置的前缀读取日志（例如。 [TEST], [DEBUG])通过增量位置跟踪实现高效轮询
  • SQLite数据库查询 --针对插件数据库的安全只读SELECT查询，具有写操作阻止功能
  • 插件健康检查 --在一次调用中组合RCON连接+错误日志扫描+数据库状态

快速开始

1.安装

# From PyPI (when published)
pip install minecraft-rcon-mcp

# Or from source
git clone https://github.com/YOUR_USERNAME/minecraft-rcon-mcp.git
cd minecraft-rcon-mcp
pip install .

2.配置

复制 .env.example 到 .env 并填写您的服务器详细信息：

cp .env.example .env

RCON_HOST=localhost
RCON_PORT=25575
RCON_PASSWORD=your_password
SERVER_DIR=/path/to/minecraft/server

# Optional
DATABASE_PATH=/path/to/plugin.db
LOG_PREFIX=[TEST]

确保您的计算机中启用了RCON server.properties:

enable-rcon=true
rcon.port=25575
rcon.password=your_password

3.跑步

# Direct
minecraft-rcon-mcp

# Or as a module
python -m minecraft_rcon_mcp

配置

变量 必填 默认 描述
RCON_HOST 没有 localhost RCON服务器主机名
RCON_PORT 没有 25575 RCON服务器端口
RCON_PASSWORD 是 -- RCON密码
SERVER_DIR 是 -- Minecraft服务器根目录
DATABASE_PATH 否 -- 插件SQLite数据库的路径
LOG_PREFIX 没有 [TEST] 筛选日志读取的前缀

工具

工具 描述 只读
run_command 在服务器上执行RCON命令 否
run_command_with_log 执行命令并捕获后续服务器日志输出 否
read_server_log 读取服务器日志中的最后N行 是
read_test_log 使用增量位置跟踪读取前缀过滤的日志条目 是
query_database 在插件SQLite数据库上执行只读SELECT查询 是
check_plugin_status 检查RCON连接、最近的错误和数据库状态 是

使用Claude Desktop

添加到您的 claude_desktop_config.json:

{
  "mcpServers": {
    "minecraft-rcon": {
      "command": "minecraft-rcon-mcp",
      "env": {
        "RCON_HOST": "localhost",
        "RCON_PORT": "25575",
        "RCON_PASSWORD": "your_password",
        "SERVER_DIR": "/path/to/minecraft/server",
        "DATABASE_PATH": "/path/to/plugin.db"
      }
    }
  }
}

使用Claude代码

添加到您的 .mcp.json:

{
  "mcpServers": {
    "minecraft-rcon": {
      "command": "minecraft-rcon-mcp",
      "env": {
        "RCON_HOST": "localhost",
        "RCON_PORT": "25575",
        "RCON_PASSWORD": "your_password",
        "SERVER_DIR": "/path/to/minecraft/server",
        "DATABASE_PATH": "/path/to/plugin.db"
      }
    }
  }
}

查找您的服务器.properties

rcon.密码= rcon.port= 启用rcon=true

用例

AI辅助插件测试

这 run_command_with_log + read_test_log combo实现了强大的自动化测试循环：

Agent writes plugin code
    → Build & deploy to server
    → run_command_with_log("mytest run")
    → read_test_log(event_filter="FAIL")
    → Agent fixes failures
    → Repeat

现场调试

check_plugin_status()           → Is the plugin loaded? Any errors?
run_command("mycommand arg")    → Execute plugin commands
read_server_log(lines=100)      → Check what happened
query_database("SELECT ...")    → Inspect plugin data

增量日志监控

# First call — read all test logs
result = read_test_log()  # returns position=12345

# After running more tests — only get NEW entries
result = read_test_log(since_position=12345)

发展

git clone https://github.com/YOUR_USERNAME/minecraft-rcon-mcp.git
cd minecraft-rcon-mcp
pip install -e .

中文说明

这是一个 MCP (Model Context Protocol) 服务器，通过 RCON 协议将 AI Agent 连接到 Minecraft 服务器。

核心功能

  • RCON 命令执行 — 支持自动重连
  • 命令 + 日志捕获 — 执行命令后自动抓取服务器日志输出
  • 日志过滤读取 — 按前缀过滤日志，支持增量读取（位置追踪）
  • 数据库只读查询 — 安全的 SQLite SELECT 查询，自动拦截写操作
  • 插件健康检查 — RCON 连通性 + 错误日志 + 数据库状态一键检查

典型工作流

AI Agent 编写插件代码
    → 构建部署到服务器
    → run_command_with_log("cvtest all")     ← 执行测试
    → read_test_log(event_filter="SUMMARY")  ← 查看结果
    → read_test_log(event_filter="FAIL")     ← 查看失败详情
    → Agent 修复问题 → 重复

这个 MCP 服务器在真实的 AI 辅助 Minecraft 插件开发中经过了充分验证（248 个测试用例全部通过）。

许可证

麻省理工学院

相关 MCP