Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| RCON_HOST | No | RCON server hostname | localhost |
| RCON_PORT | No | RCON server port | 25575 |
| LOG_PREFIX | No | Prefix for filtered log reading | [TEST] |
| SERVER_DIR | Yes | Minecraft server root directory | |
| DATABASE_PATH | No | Path to plugin SQLite database | |
| RCON_PASSWORD | Yes | RCON password |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| run_command | Execute an RCON command on the Minecraft server (without leading slash). Examples: ``say Hello``, ``gamemode creative Steve``, ``tp Steve 0 64 0`` |
| run_command_with_log | Execute an RCON command and capture server log output produced afterwards. Useful for commands whose feedback appears in the server log rather than the
RCON response (e.g. plugin commands that print results via logger).
Args:
command: The Minecraft command to execute.
wait_seconds: Seconds to wait for log output after execution (default 2). |
| read_server_log | Read the last N lines from the Minecraft server log file. Args:
lines: Number of lines to read from the end of the log (default 50). |
| read_test_log | Read plugin test/debug logs filtered by a configurable prefix. Only lines containing the configured LOG_PREFIX (default ``[TEST]``) are
returned. Supports incremental reading: pass the ``position`` value from a
previous call as ``since_position`` to only get new entries.
Args:
since_position: Byte offset to start reading from (0 = beginning).
event_filter: Optional event type filter (e.g. ``PASS``, ``FAIL``,
``SUMMARY``). Only lines matching ``{prefix} {event_filter}`` are
returned. |
| query_database | Execute a read-only SELECT query against the plugin's SQLite database. Write operations (INSERT, UPDATE, DELETE, DROP, etc.) are blocked. Results
are returned as a formatted ASCII table.
Args:
sql: A SELECT SQL statement. |
| check_plugin_status | Check overall plugin health: RCON connectivity, recent errors in the server log, and database file status. Recommended to call before running tests or debugging. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |