minecraftcodefoundary/minecraft-mcp-server

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

11 stars 3 forks 品質 71 トレンド 18MIT

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