minecraftcodefoundary/minecraft-mcp-server

Developer tools

이 페이지는 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 MCP 초보자라면? 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"
      }
    }
  }
}