MCP server for Minecraft mod development - provides decompiled code access, symbol search, and runtime interaction via DebugBridge
MCP server for Minecraft mod development - provides decompiled code access, symbol search, and runtime interaction via DebugBridge
An MCP (Model Context Protocol) server that empowers AI coding agents to work effectively with Minecraft mod development. Provides both static analysis of decompiled source code and runtime interaction with a running Minecraft instance.
| Dependency | Version | Purpose | |------------|---------|---------| | Node.js | 18+ | Runtime | | Java | 8+ | Decompilation (Vineflower) & callgraph | | ~2GB | disk | Decompiled sources + cache | > Note: Java 17+ is recommended for the callgraph command due to Gradle compatibility.
mc_run_command — MCDEV_RUN_COMMAND=1 (or true)mc_script_logs — MCDEV_SCRIPT_LOGS=1 (or true)serve — Start the MCP server over stdio (launched by MCP clients — not run by humans)status — Show all initialized versions and what stage each one is atmc_version — Manage the active Minecraft version. Call with action: "set" before other static tools, or action: "list" to see what's initialized.mc_search — Search decompiled source code for classes, methods, or fields by name pattern.mc_get_class — The mc_get_class tool exposed by this server.mc_get_method — The mc_get_method tool exposed by this server.mc_find_refs — Find who calls a method (callers) or what it calls (callees).mc_list_classes — List all classes under a specific package path (includes subpackages).mc_list_packages — List all available packages. Optionally filter by namespace.mc_find_hierarchy — Find classes that extend or implement a given class or interface.mc_connect — Connect to a running Minecraft instance. Other runtime tools auto-connect if needed. Pass reset: true to disconnect and clear state before reconnecting (useful when switching instances). If port is omitted, scans ports 9mc_execute — Execute Groovy code in the running game. The binding persists across calls, and mc / player / level are pre-bound. (The runtime migrated from Lua to Apache Groovy 5 in mid-2026 — the tool description carries a Lua→GroovyCompare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.
Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.
| Tool | What it does |
|---|---|
| mc_version | |
| mc_search | |
| mc_get_class | |
| mc_get_method | |
| mc_list_classes | |
| mc_list_packages | |
| mc_find_hierarchy | |
| mc_find_refs | |
| Direction | Description |
| callers | Find methods that call this method |
| callees | Find methods this method calls |
| Namespace | Description |
| minecraft | Minecraft client classes |
| fabric | Fabric API classes (if indexed) |
| subclasses | Classes that extend this class |
| implementors | Classes that implement this interface |
| mc_connect | |
| mc_execute | |
| mc_snapshot | |
| mc_screenshot | |
| mc_record_video | |
| mc_screen_inspect | |
| mc_chat_history | |
| mc_nearby_entities | |
| mc_entity_details | |
| mc_looked_at_entity | |
| mc_nearby_blocks | |
| mc_block_details | |
| mc_set_entity_glow | |
| mc_set_block_glow | |
| mc_clear_block_glow | |
| mc_get_item_texture | |
| mc_get_item_texture_by_id | |
| mc_get_entity_item_texture | |
| mc_join_server | |
| mc_leave_server | |
| mc_wait_until_in_world | |
| mc_quit_client | |
| mc_wait_for_bridge |
{
"mcpServers": {
"mcdev": {
"command": "npx",
"args": [
"-y",
"mcdev-mcp",
"serve"
]
}
}
}From the project documentation. Replace placeholders and example paths before connecting.
| Dependency | Version | Purpose | |------------|---------|---------| | Node.js | 18+ | Runtime | | Java | 8+ | Decompilation (Vineflower) & callgraph | | ~2GB | disk | Decompiled sources + cache | > Note: Java 17+ is recommended for the callgraph command due to Gradle compatibility.
Enables AI agents to interact with Minecraft using the Model Context Protocol via Mineflayer.
Automates Unity workflows and manipulates assets using local large language models via Ollama.
This project started because I wanted to prototype a dam.
Steam store/game data (no key) plus player profiles, libraries and achievements (Steam Web API).
Premium MCP (Model Context Protocol) server for AI-powered Godot game development. Connects AI assistants like Claude directly to your Godot editor
Daily content for AI agents. History, chess, investing, wrongology, more. 10 channels. Free trial.