MC AI Coding Assistant Tool MCP
MC-AI-Coding-Assistant-Tool
A local MCP server for Minecraft modding: loader rules, documentation, mappings, crash triage and in-game playtesting for agents.
- 138 ★ on the repository
- Last commit
Extended access
Why this level
- The server writes project files and host configuration and runs Gradle and the game itself.
- Before writing configuration the agent shows a diff and waits for confirmation.
Install
- Works in
Manual install
cd mcp-server && npm ci && npm run buildRun it inside the cloned repository; the agent generates the host configuration from `AUTO_SETUP.md` and shows a diff before writing.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The server writes project files and host configuration and runs Gradle and the game itself.
- Before writing configuration the agent shows a diff and waits for confirmation.
This is third-party code. Review the repository files before installing.
What it does
MC AI Coding Assistant Tool is a local stdio MCP server with 89 tools for Minecraft mod development. It knows the rules of Forge, Fabric, NeoForge, Quilt, LiteLoader, Rift, ModLoader, Bedrock Add-On and the Paper and Spigot server plugins, searches official documentation for the right version and converts names across six mapping systems. The server scaffolds projects, diagnoses Gradle, triages crash reports, decompiles game sources and mod JAR files, analyses porting a mod between loaders and runs in-game self-testing with screenshots and `qa.log`. The repository carries rules and API summaries for 48 library mods.
Who it is for. Minecraft mod and modpack developers who code with Cursor or Claude Code and suffer from outdated API versions and mapping confusion.
Good fit when
- The agent invents API methods missing from your Forge or Fabric version.
- A crash report must be analysed to find the likely cause.
- A mod exists only for Forge while the game runs on Fabric: a porting path analysis comes first.
- A new project is built from a scaffold with the rules of the right platform and version.
- A change is verified in the game itself with screenshots and a log.
Not a fit when
- The work has nothing to do with Minecraft: the server covers only modding and game server plugins.
- The project is commercial: the code is distributed under the PolyForm Noncommercial licence.
- The machine runs Node.js older than 22.5.
Example request
Detect the platform and exact version of my mod, load the rule pack and explain how to register a new block.MCP
- Transport
- stdio
- Authentication
- not required
Environment variables
MC_SKILL_DATA- Root of the offline documentation and mapping data.
MC_SKILL_CACHE- Cache directory for decompiled sources.
Limitations
Node.js 22.5 or newer is required. On 22.5–22.12 and 23.0–23.3 the server must start with `--experimental-sqlite` or it exits with an error. The code is distributed under PolyForm Noncommercial 1.0.0 with copyleft terms, and commercial use is forbidden. The in-game driver check works on Minecraft 1.20.1 and newer for Fabric, Quilt, Forge and NeoForge. The agent writes host configuration only after you confirm the diff.
How to disable. Remove the `MC-AI-Coding-Assistant-Tool` server entry from your agent MCP configuration and reload it. The cloned directory can be erased together with the cache from `MC_SKILL_CACHE`.
FAQ
How do I install the Minecraft modding MCP server?
Ask the agent to install the repository. It detects the host, builds the server with `npm ci && npm run build` in `mcp-server`, shows the configuration diff and writes it after your confirmation. After reloading the host, call `get_server_status`.
Does it work without an MCP connection?
Yes. If tools are not visible or you do not want to reload the host, the agent can call the CLI: `node mcp-server/dist/cli.js`, for example with `activate_platform_pack --action=list`.
Which platforms are supported?
Forge, Fabric, NeoForge, Quilt, LiteLoader, Rift, ModLoader, Bedrock Add-On and the Paper and Spigot servers. Main versions: Forge 1.20.1, Fabric 1.20.1, 1.21.x, 26.1.2 and 26.2.
How does the server prevent version mix-ups?
The agent detects the platform and exact version from `AGENTS.md`, then loads the rule pack with `activate_platform_pack action=session`. Neighbouring versions are not substituted.
Can the server be used in a commercial project?
No. The code is distributed under PolyForm Noncommercial 1.0.0 with copyleft: attribution is required and derivative works are opened under the same licence.
Discussion
No questions or reviews yet.
Related
MCP serversAn MCP server that lets an agent read files, search code and run commands in a workspace
13 skills for Codex and Claude Code cover Minecraft modding, plugins, datapacks, resource packs and server administration.
Cocos Creator MCP Server
Cocos Creator MCP Server Plugin
An MCP server as a Cocos Creator editor extension: the agent controls scenes, nodes, components, prefabs and project assets
A command-line debugger for MCP servers from Giant Swarm: a REPL for tools, OAuth 2.1 and an MCP server mode for Cursor
The MCP server finds definitions and meaningful code fragments through a local index with vector and full-text search.
SourceCraft MCP and CLI: repos and CI/CD
SourceCraft MCP Server
An MCP server, CLI tool and skill for Yandex's SourceCraft development platform: repositories, issues, pull requests, CI/CD and releases, 48 tools
README in short
The repository is split into loader folders with rules and skills, offline documentation and mapping data, a community knowledge base and the server itself in `mcp-server`. Verification goes in steps: from build and static analysis to in-game checks and multi-client tests.