Log inSubmit server
Minecraft Modding MCP logo

Minecraft Modding MCP

by @adhisang

Inspect Minecraft source, mappings, versions, mod JARs, project files, and NBT through MCP tools.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Minecraft Modding MCP

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "adhisang-minecraft-modding-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@adhisang/minecraft-modding-mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 41 tools correctly (2d ago).

Overview

@adhisang/minecraft-modding-mcp MCP server supports AI-assisted Minecraft modding through a stdio MCP process. It lets agents inspect decompiled Minecraft source, translate symbols across mapping namespaces, compare versions, analyze Fabric, Forge, and NeoForge JARs, and validate Mixin, Access Widener, and Access Transformer files. Reach for it when an MCP client needs version-aware source investigation, mod compatibility analysis, or project validation. Node.js 22.13.0 or newer is required, and Java 17 or newer is needed for several decompilation and remapping workflows.

Use cases

  • Inspect decompiled Minecraft classes and source files
  • Resolve symbols across Mojang, Yarn, Intermediary, and obfuscated namespaces
  • Compare Minecraft releases for class, registry, and migration changes
  • Analyze Fabric, Forge, or NeoForge mod JARs
  • Validate Mixin, Access Widener, and Access Transformer files

Key features

  • Mapping-aware Minecraft source inspection
  • Cross-version class and registry comparison
  • Fabric, Forge, and NeoForge JAR analysis
  • Workspace and project validation
  • NBT encoding, decoding, and patching
  • SQLite-backed cache management

Tools41

What Minecraft Modding MCP lets your agent do. Expand a tool for its parameters.

Verified live~23.4k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

What it can do

From the 41 tools this server returned when we ran it; 41 declare their own safety hints.

Read-only tools · 41
Network at startup3 connections
Files written at startupNone
Install scriptsNone
npm provenanceSigned build
Package age239 days
Maintainers1

Observed 2026-10-26 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 12d ago via OSV.dev · @adhisang/minecraft-modding-mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars8Stargazers on the source repository.
npm downloads781Package downloads in the last 30 days.
Last commit5d agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed41Callable tools this server registers over MCP.

How Minecraft Modding MCP works

What @adhisang/minecraft-modding-mcp MCP server does

@adhisang/minecraft-modding-mcp MCP server provides tools for investigating Minecraft internals and mod projects from an MCP-compatible client. It can inspect version metadata, artifacts, indexed files, classes, source text, and workspace symbols. Mapping-aware operations cover the obfuscated, mojang, intermediary, and yarn namespaces.

The server also supports cross-version analysis. Agents can check whether classes, fields, or methods exist, trace a symbol across releases, compare class signatures, review registry changes, and produce migration-oriented summaries. For mod development, it reads metadata and dependencies from Fabric, Forge, and NeoForge JARs, examines entrypoints and Mixin configuration, searches decompiled code, and previews or applies remappings.

NBT workflows are included for Java Edition binary data. Typed JSON can be encoded to NBT, decoded from NBT, or modified with RFC 6902 patches. Project-oriented checks cover Mixin source, .accesswidener files, and Forge or NeoForge Access Transformer files.

How it works

@adhisang/minecraft-modding-mcp MCP server runs locally over stdio and exposes workflow-oriented entry points alongside more specialized tools. The main workflows are inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project, and manage-cache. Additional tools handle artifact resolution, class lookup, source retrieval, mapping queries, lifecycle tracing, version listing, indexing, NBT conversion, and mod-JAR inspection.

A SQLite-backed cache stores indexed and downloaded data. The server can expose versions, artifact metadata, mappings, and class source through MCP resources. Source operations may resolve an artifact from a Minecraft version, a JAR path, or Maven coordinates; workspace-aware operations can use a Gradle project and its compile-visible symbols.

Setup and configuration

Install Node.js 22.13.0 or newer, then run npx -y @adhisang/minecraft-modding-mcp as the MCP server command. The same command can be registered with Claude Desktop, Claude Code, VS Code, Codex CLI, Gemini CLI, or another MCP-capable client. The server accepts both newline-delimited and Content-Length stdio framing.

Java 17 or newer on PATH is required for workflows that need decompilation or remapping, including some Minecraft source lookups and mod-JAR decompilation. Registry generation and registry comparisons may require the Java version expected by the selected Minecraft release. If automatic helper-JAR downloads are unavailable, configure MCP_VINEFLOWER_JAR_PATH and MCP_TINY_REMAPPER_JAR_PATH. MCP_CACHE_DIR changes the cache location, while MCP_MAPPING_SOURCE_PRIORITY can select mapping-source priority.

Tools and capabilities

  • Inspect versions, artifacts, classes, files, source, and workspace context.
  • Resolve mappings, exact method mappings, workspace symbols, and API matrices.
  • Find classes, including classes inside nested JARs, and read members from bytecode.
  • Search indexed Minecraft source or decompiled mod source.
  • Compare releases, class signatures, registries, and symbol lifecycles.
  • Analyze mod metadata, dependencies, entrypoints, Mixins, access transformers, and remap operations.
  • Validate projects, manage cache cleanup, and convert or patch NBT data.

Limitations and notes

The process serves one MCP protocol era selected from the client’s first signal. Source and cache-backed calls may need a gradleUserHome value when a build uses a non-default Gradle User Home. The server searches supported Loom cache locations rather than accepting arbitrary Loom cache directories. Full source reads are subject to byte limits, and paginated artifact-file listings use cursors.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Minecraft Modding MCP

@adhisang/minecraft-modding-mcp is an MCP server that connects AI clients to Minecraft source, mappings, versions, mod JARs, workspaces, and NBT data. Its main tools inspect Minecraft, analyze symbols and mods, compare versions, validate projects, resolve artifacts, search source, and manage cached data over stdio.

Run `npx -y @adhisang/minecraft-modding-mcp` as the server command. Register that command in an MCP client such as Claude Desktop, Claude Code, VS Code, Codex CLI, or Gemini CLI. Node.js 22.13.0 or newer is required.

Yes, @adhisang/minecraft-modding-mcp works with Claude Desktop over stdio. Add an MCP server entry that uses `npx` with `-y` and the package name as its argument.

Java 17 or newer is needed for decompilation and remapping workflows. Registry generation and registry comparisons may require the Java version specified by the selected Minecraft release, such as Java 21 for Minecraft 1.21.x.

Related MCP servers

All in Gaming All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewMinecraft Modding MCP AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/adhisang-minecraft-modding-mcp?style=directory)](https://allmcps.com/mcp/adhisang-minecraft-modding-mcp)
HTML Embed
<a href="https://allmcps.com/mcp/adhisang-minecraft-modding-mcp"><img src="https://allmcps.com/api/badge/adhisang-minecraft-modding-mcp?style=directory" alt="Minecraft Modding MCP on AllMCPs" /></a>