fabricator-panel-mcp — Claude Code MCP server: Minecraft server
Hooks your AI client up to the Fabricator panel over its HTTP API, so you can find out why a modpack server keeps crashing.
claude mcp add --env FABRICATOR_URL=<FABRICATOR_URL> --env FABRICATOR_TOKEN=<FABRICATOR_TOKEN> --transport stdio mcp -- uvx fabricator-panel-mcpWhat fabricator-panel-mcp does
The server runs on your own machine beside the MCP client and reaches the Fabricator panel through its HTTP API. You mint the token in the panel under Settings, in the Model Context Protocol section. From there the assistant reads the log, checks which mods are installed, looks a mod up on Modrinth, removes or updates it, and restarts the server.
The token scope decides what is reachable, and the panel enforces it. With read you get the server list, console output and crash logs, installed mods with compatible updates, Modrinth compatibility checks, CPU and memory figures, Java and install diagnostics, backup coverage and snapshot metadata. A manage token adds start, stop and restart, installation from the saved configuration, installing or updating a single mod by Modrinth project id, and deleting mod jars. For pure diagnosis read is enough, since it cannot change anything.
uv has to be installed and on your PATH. Without it the client reports the server as failing to launch or dropping at startup, which reads like a panel or token fault even though the process never starts. The token sits in plain text in the client config, never expires, and is read from environment variables rather than command-line arguments. Jars nested in subfolders of mods do not show up in the listing and cannot be removed with remove_mods.
What it helps with
- work out why a modpack server crashes
- read a crash log and console output
- check an installed mod against Modrinth
- update one mod by project id
- see CPU and memory use of a server
Example prompts for the agent
- Read the last crash log and tell me which mod is taking the server down
- Check the installed mods for compatible updates on Modrinth
- Restart the server and show me what the console prints on boot
How to install fabricator-panel-mcp
Platform CLI
claude mcp add --env FABRICATOR_URL=<FABRICATOR_URL> --env FABRICATOR_TOKEN=<FABRICATOR_TOKEN> --transport stdio mcp -- uvx fabricator-panel-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from fabricator-panel-mcp <command>
Platform CLI
codex mcp add mcp --env FABRICATOR_URL=<FABRICATOR_URL> --env FABRICATOR_TOKEN=<FABRICATOR_TOKEN> -- uvx fabricator-panel-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from fabricator-panel-mcp <command>
Config file
{
"mcpServers": {
"mcp": {
"command": "uvx",
"args": [
"fabricator-panel-mcp"
],
"env": {
"FABRICATOR_URL": "<FABRICATOR_URL>",
"FABRICATOR_TOKEN": "<FABRICATOR_TOKEN>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from fabricator-panel-mcp <command>
Config file
{
"servers": {
"mcp": {
"type": "stdio",
"command": "uvx",
"args": [
"fabricator-panel-mcp"
],
"env": {
"FABRICATOR_URL": "<FABRICATOR_URL>",
"FABRICATOR_TOKEN": "<FABRICATOR_TOKEN>"
}
}
}
}Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from fabricator-panel-mcp <command>
Platform CLI
gemini mcp add -e FABRICATOR_URL=<FABRICATOR_URL> -e FABRICATOR_TOKEN=<FABRICATOR_TOKEN> mcp uvx fabricator-panel-mcpReplace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from fabricator-panel-mcp <command>
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about fabricator-panel-mcp
How do I install fabricator-panel-mcp in Claude Code?
Run claude mcp add fabricator-panel-mcp -e FABRICATOR_TOKEN=<FABRICATOR_TOKEN> -- uvx fabricator-panel-mcp. If the panel is not on http://127.0.0.1:5000, pass the address too: claude mcp add --env FABRICATOR_URL=<FABRICATOR_URL> --env FABRICATOR_TOKEN=<FABRICATOR_TOKEN> --transport stdio mcp -- uvx fabricator-panel-mcp.
What does fabricator-panel-mcp do?
It gives the assistant access to the Fabricator panel: server list, logs and console, installed mods, update checks through Modrinth, plus start, restart and mod changes when the token is manage.
What do I need before it works?
A panel reachable from this machine with MCP access switched on, an API token from its settings, and uv on your PATH. Without uv the client shows the server as failing to start.
