minecraftcodefoundary/minecraft-mcp-server

开发工具

本页由 AI 翻译，技术细节请以原文为准。查看原文

11 stars 3 forks 质量 71 趋势 8MIT

Repository Install

A wonderful MCP tool in debug Minecraft Server with RCON

概览

An MCP (Model Context Protocol) server that connects AI agents to Minecraft servers through RCON. Execute commands, monitor logs, query databases, and check plugin health — all from your AI coding assistant. Built and battle-tested during real AI-assisted Minecraft plugin development. - — Run any server command with automatic reconnection on failure - — Execute a command and capture the server log output that follows (unique and powerful for plugin debugging) - — Tail the latest server log - — Read logs by configurable prefix (e.g. [TEST], [DEBUG]) with incremental position tracking for efficient polling - — Safe read-only SELECT queries against plugin databases, with write-operation blocking - — Combined RCON connectivity + error log scan + database status in one call Copy .env.example to .env and fill in your server details: Make sure RCON is enabled in your server.properties: rcon.password= rcon.

README

以下为原文 README 节选，完整内容请查看原文。

⛏️ Minecraft RCON MCP Server

Built and battle-tested during real AI-assisted Minecraft plugin development.

Features

RCON Command Execution — Run any server command with automatic reconnection on failure
Command + Log Capture — Execute a command and capture the server log output that follows (unique and powerful for plugin debugging)
Server Log Reading — Tail the latest server log
Filtered Log Monitoring — Read logs by configurable prefix (e.g. [TEST], [DEBUG]) with incremental position tracking for efficient polling
SQLite Database Queries — Safe read-only SELECT queries against plugin databases, with write-operation blocking
Plugin Health Checks — Combined RCON connectivity + error log scan + database status in one call

Quick Start

1. Install

# 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. Configure

Copy .env.example to .env and fill in your server details:

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]

Make sure RCON is enabled in your server.properties:

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

3. Run

# Direct
minecraft-rcon-mcp

# Or as a module
python -m minecraft_rcon_mcp

Configuration

Variable	Required	Default	Description
`RCON_HOST`	No	`localhost`	RCON server hostname
`RCON_PORT`	No	`25575`	RCON server port
`RCON_PASSWORD`	Yes	—	RCON password
`SERVER_DIR`	Yes	—	Minecraft server root directory
`DATABASE_PATH`	No	—	Path to plugin SQLite database
`LOG_PREFIX`	No	`[TEST]`	Prefix for filtered log reading

Tools

Tool	Description	Read-Only
`run_command`	Execute an RCON command on the server	No
`run_command_with_log`	Execute a command and capture subsequent server log output	No
`read_server_log`	Read the last N lines from the server log	Yes

在 GitHub 查看完整 README

安装

This server does not publish a one-line install command.

Open the repository installation guide 新手？先看 mcpskill.org 教程 →

配置

{
  "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"
      }
    }
  }
}