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
MCP server

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.
All reasons and checks

guguzea/mc-ai-coding-assistant-tool

Install

Manual install

cd mcp-server && npm ci && npm run build

Run 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 review

Extended 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.

An MCP server that lets an agent read files, search code and run commands in a workspace

MCP serverBroad access1.2KRepository stars

13 skills for Codex and Claude Code cover Minecraft modding, plugins, datapacks, resource packs and server administration.

PluginExtended access199Repository stars

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

MCP serverExtended access1.5KRepository stars
Official

A command-line debugger for MCP servers from Giant Swarm: a REPL for tools, OAuth 2.1 and an MCP server mode for Cursor

CLIExtended access38Repository stars
Official

The MCP server finds definitions and meaningful code fragments through a local index with vector and full-text search.

MCP serverExtended access349Repository stars
Russian stack

An MCP server, CLI tool and skill for Yandex's SourceCraft development platform: repositories, issues, pull requests, CI/CD and releases, 48 tools

MCP serverBroad access

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.

README badge

Report a problem