What can you do with this server?

This server lets you search Minecraft obfuscated ↔ deobfuscated name mappings for classes, methods, and fields across 38 Minecraft versions (1.7.10 – 1.20.1). * Search mappings — Translate obfuscated names (e.g., aed, func_70091_d) to readable ones (e.g., EntityPlayer, getAbsorptionAmount) and vice versa. * Boolean expression search — Combine terms with AND (&), OR (|), and grouping ({}) for powerful queries (e.g., Entity&Player, {Block|Item}&client). * Column-targeted search — Restrict searches using modifiers: classname, package, method, field, desc, modifier, side, and more. Supports substring (term:modifier) and exact (term::modifier) matching. * Paginated results — Browse large result sets with configurable page and limit (up to 100 per page). * Custom output formatting — Define output templates using %variable% placeholders (e.g., %deobf_class%, %srg_name%, %obf_name%) with automatic deduplication. * Auto-caching — Mapping data is automatically downloaded from NeoForge Maven and Mojang servers and cached locally for fast subsequent lookups. * Cross-version support — Track renamed or moved APIs across versions when porting mods. * Broad ecosystem compatibility — Useful for Forge/NeoForge, Fabric, Spigot/Paper, Mixin/Access Transformer configs, reflection-based code, and scripting engines.

Which integrations are available for this server?

Enables AI agents using Codeium (Windsurf) to search Minecraft obfuscated name mappings, assisting with modding, plugin development, and reflection-based code by resolving obfuscated class, method, and field names.

How do I use Native MC Mapping MCP Server?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Native MC Mapping MCP Server Find the deobfuscated name for func_70091_d in 1.12.2" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Native MC Mapping MCP Server

by SaltfishSheep

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

English | 中文

Native MC Mapping MCP Server

An MCP (Model Context Protocol) server that provides Minecraft obfuscated name mapping lookups. Helps AI coding agents work with Minecraft's obfuscated Java internals — for modding, plugin development, Mixin, Access Transformers, reflection-based scripting, and more.

What It Does

Minecraft's Java code is obfuscated at runtime — class, method, and field names are replaced with short meaningless identifiers (aed, func_70091_d, m_91087_). This MCP server lets your AI agent:

Search obfuscated ↔ deobfuscated mappings across 38 Minecraft versions (1.7.10 – 1.20.1)
Auto-build mapping caches on first use — downloads from NeoForge Maven and Mojang servers
Boolean expression search — Entity&Player, {Block|Item}&client, func_149645

Use Cases

Scenario	How This Helps
Forge / NeoForge modding	Look up obfuscated method/field names when writing mixins or AT configs
Fabric modding	Find intermediary ↔ named mappings for access wideners
Spigot / Paper plugins	Resolve NMS (net.minecraft.server) class names across versions
Mixin / Access Transformers	Discover the exact obfuscated name to target
Reflection-based code	Find field/method names for `getDeclaredField`, `getMethod`, etc.
Scripting engines	Resolve native Minecraft API names (CustomNPCs, CraftTweaker, etc.)
Porting mods	Compare mappings between MC versions to find renamed APIs

MCP Tools

Tool	Description
`search`	Search Minecraft obfuscated class/method/field name mappings

Related MCP server: modforge

Quick Install (MCP Client)

Prerequisites

Node.js ≥ 18

Step 1: Clone & Build

git clone https://github.com/SaltfishSheep/AI-MCP-NativeMinecraftAccess.git
cd AI-MCP-NativeMinecraftAccess
npm install
npm run build

Step 2: Add to Your MCP Client

Add the following to your MCP client configuration:

Claude Desktop (claude_desktop_config.json):

{
  "mcpServers": {
    "native-mc-access": {
      "command": "node",
      "args": ["/absolute/path/to/AI-MCP-NativeMinecraftAccess/dist/index.js"]
    }
  }
}

OpenCode (opencode.json):

{
  "mcp": {
    "native-mc-access": {
      "type": "local",
      "command": ["node", "/absolute/path/to/AI-MCP-NativeMinecraftAccess/dist/index.js"],
      "enabled": true
    }
  }
}

Cursor (.cursor/mcp.json):

{
  "mcpServers": {
    "native-mc-access": {
      "command": "node",
      "args": ["/absolute/path/to/AI-MCP-NativeMinecraftAccess/dist/index.js"]
    }
  }
}

Windsurf (~/.codeium/windsurf/mcp_config.json):

{
  "mcpServers": {
    "native-mc-access": {
      "command": "node",
      "args": ["/absolute/path/to/AI-MCP-NativeMinecraftAccess/dist/index.js"]
    }
  }
}

Replace /absolute/path/to/ with the actual path where you cloned the repo.

Usage

Once configured, your AI agent can call the search tool:

search(mc_version="1.12.2", expression="Entity&Player")

Tool Parameters

Parameter	Type	Required	Default	Description
`mc_version`	string	Yes	-	Minecraft version (e.g. "1.12.2", "1.20.1")
`expression`	string	Yes	-	Boolean search expression
`page`	number	No	1	Page number (1-indexed)
`limit`	number	No	20	Results per page (max 100)
`output`	string	No	default template	Output format template using `%variable%` syntax

Output template variables: %type%, %obf_class%, %deobf_class%, %obf_name%, %deobf_name%, %srg_name%, %obf_desc%, %deobf_desc%, %access%, %is_static%, %sideonly%, %match%, %mismatch%

Example queries:

Query	Description
`Entity&Player`	Entries containing both "Entity" AND "Player"
`Entity::classname`	Class name exactly "Entity"
`walk:method`	Methods with "walk" in name
`static::modifier`	is_static exactly "static"
`Potion:classname&Duration:name`	Class name "Potion", name "Duration"
`{Block\|Item}&client`	Client-side Block or Item entries
`func_70091_d`	Find a specific SRG method name by ID
`KeyBinding`	All entries mentioning KeyBinding
`output="%deobf_class%"`	Deduplicated class list

Expression syntax:

Syntax	Meaning	Example
`term`	Case-insensitive substring match (exact case scores higher)	`KeyBinding`
`term:modifier`	Restrict search to specific columns	`Potion:classname`, `walk:method`
`term::modifier`	Strong modifier — exact match required	`Entity::classname`
`net.minecraft.Entity`	Dot notation — matches `net/minecraft/Entity` and `net/minecraft$Entity`	`net.minecraft.entity.Entity`
`&`	AND (both must match, higher precedence)	`Entity&Living`
`\|`	OR (either must match)	`Entity\|Player`
`{}`	Grouping	`{a\|b}&c`

Modifiers:

Modifier	Searches	Description
`all`	all columns	Default — searches all text columns (excludes sideonly)
`class`	obf_class, deobf_class	Full class path (e.g. `net/minecraft/entity/Entity`)
`classname`	deobf_class (after last `/`)	Class name only (e.g. `Entity` from `net/minecraft/entity/Entity`)
`package`	deobf_class (before last `/`)	Package only (e.g. `net/minecraft/entity`)
`name`	obf_name, deobf_name, srg_name	Field/method names (methods+fields only)
`method`	obf_name, deobf_name, srg_name	Method names only (filters type=method)
`field`	obf_name, deobf_name, srg_name	Field names only (filters type=field)
`desc`	obf_desc, deobf_desc	Method/field descriptors
`modifier`	access, is_static	Access level and static status (note: `access` is always empty — data sources lack access info)
`side`	sideonly	Side filter (common/server/client)

Tips: Use Player&Entity instead of PlayerEntity for cross-version compatibility, as naming conventions differ across MC versions.

Supported Versions

38 Minecraft versions across 4 workflow types:

Workflow	Versions	Data Sources
Legacy SRG	1.7.10, 1.8, 1.8.8–1.9.4, 1.10.2–1.11.2	SRG ZIP + MCP Stable CSV + static_methods
Legacy TSRGv1	1.12.2–1.14.4, 1.15–1.15.2	TSRGv1 + MCP Stable CSV + static_methods + constructors
Legacy ProGuard	1.16.1–1.16.5	TSRGv1 + Mojang ProGuard + static_methods
Modern	1.17–1.17.1, 1.18–1.18.2, 1.19–1.19.4, 1.20–1.20.1	TSRGv2 + Mojang ProGuard

How It Works

On first search for a given MC version, the server downloads mapping data from NeoForge Maven and Mojang
It parses SRG/TSRG/ProGuard formats and merges them with MCP CSV data
The merged cache is stored as .mapping-caches/<version>.csv
Subsequent searches use the cached data (validated against package.json version)
Boolean expressions are parsed into an AST and evaluated against all CSV rows

Output Format

Format: [type] obf_class/obf_name -> deobf_class deobf_name srg_name obf_desc deobf_desc access is_static sideonly
Found 382 results for "Entity&Player" in MC 1.12.2 (page 1/39)

  1. [method] aed/cD -> net/minecraft/entity/player/EntityPlayer.getAbsorptionAmount func_110139_bj ()F  non-static common
  2. [method] aed/bM -> net/minecraft/entity/player/EntityPlayer.applyEntityAttributes func_110147_ax ()V  non-static common
  ...

Project Structure

AI-MCP-NativeMinecraftAccess/
├── package.json
├── tsconfig.json
├── src/
│   ├── index.ts              # MCP server entry point
│   ├── types.ts              # TypeScript type definitions
│   ├── util.ts               # Shared utilities (CSV parsing, package version)
│   ├── version-table.ts      # URL mapping table for 38 MC versions
│   ├── builder/
│   │   ├── index.ts          # buildMappingCache entry point
│   │   ├── download.ts       # HTTP fetch + minimal ZIP reader
│   │   ├── parsers.ts        # SRG, TSRGv1, TSRGv2, ProGuard, CSV parsers
│   │   ├── workflows.ts      # 4 merge workflow builders
│   │   └── cache.ts          # CSV cache writer + mapping-info update
│   └── search/
│       ├── index.ts          # Barrel exports
│       ├── expression.ts     # Boolean expression parser (AND/OR/braces)
│       └── csv-reader.ts     # CSV reader + scoring + in-memory cache
├── dist/                     # Built JavaScript (entry: dist/index.js)
└── .mapping-caches/          # Generated cache files (gitignored)

License

MIT License — see LICENSE.

Third-Party Data

Mojang mappings — Provided under Mojang's custom license. This server fetches them at runtime; it does NOT redistribute them.
MCP mappings — Maintained by the Mod Coder Pack community, distributed via NeoForge Maven.

Available Tools

1 tool

searchSearch Native MC AccessA

Read-onlyIdempotent

Search Minecraft obfuscated↔deobfuscated name mappings (classes/methods/fields).

expression syntax: term — case-insensitive substring term:modifier — substring match in column; term::modifier — exact match in column a&b (AND) | a|b (OR) | {expr} (grouping). & has higher precedence than |. "net.minecraft.Entity" auto-expands to "/" and "$" paths. Cross-version tip: "Player&Entity" works better than "EntityPlayer".

Modifiers: all (default) — all columns class — obf_class, deobf_class (full path) classname — class name after last '/' package — package before last '/' name — obf_name, deobf_name, srg_name (methods+fields) method — same columns, methods only field — same columns, fields only desc — obf_desc, deobf_desc modifier — access, is_static side — sideonly (common/server/client)

Scoring: exact case hit = 1.0, case-insensitive = 0.5, then by mismatch (less unmatched chars ranks higher).

Common patterns: "Entity::classname" → exact class name only "Gui:classname" → all classes containing "Gui" "net/minecraft/inventory:package" → all classes under a package "health:field" → fields only, no methods "()Z:desc" → methods returning boolean "get:method&static::modifier" → static methods containing "get" output="%deobf_class%" → deduplicated class list

Inputs: mc_version (required), expression (required), page, limit, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

Deploy Server

Claude Code, inside the Godot 4 editorFlockbay puts an AI agent in the real Godot 4 editor: it writes GDScript, runs your game and fixes what breaks. Free, or bring your own Claude Code or Codex.flockbay.comAd

TDQS

A4.6/5.0

Scored 2026-06-23 12:25 across 1 tool

Disambiguation5/5

Only one tool exists, so there is no possibility of confusion between tools. The tool's purpose is clearly delineated.

Naming Consistency5/5

With a single tool named 'search', naming is trivially consistent. The verb-only name is appropriate for its action.

Tool Count4/5

One tool is slightly below the typical range of 3-15, but the search tool is highly capable and expressive, covering a broad search domain. It earns its place.

Completeness5/5

The search tool provides comprehensive coverage for querying Minecraft mappings: it supports classes, methods, fields, multiple modifiers, boolean expressions, and scoring. No obvious gaps for a search-only server.

Maintenance

ActivityInactive

ResponsivenessOutdated data

Resources

Related MCP Connectors

LLMemory
io.github.meir-may
Search your AI chat history (ChatGPT, Claude, Codex) from any MCP client. Remote, private, read-only
Search Knowledge & Memory
2
https://mcp.llmemory.xyz/mcp
greadA
io.github.NitroRCr
An MCP server that gives your AI access to the source code and docs of all public github repos
Version Control Code Analysis Documentation Access
5365
https://api.gread.dev/mcp
AgentScoutA
com.agentscouthq
Read-only search over 2,065+ AI agent tools and 276 MCP servers. Free, no sign-up needed.
Search Developer Tools
51
https://mcp.agentscouthq.com/mcp
agentswitchboardA
io.github.assafbar2
Search a curated directory of 800+ AI agents, MCP servers, and agentic tools.
Search
921
https://agentswitchboard.dev/api/mcp

Related MCP Servers

Minecraft Dev MCP
Games & Gamification Code Analysis Developer Tools
MCDxAI
A
license
Not graded
quality
C
maintenance
A Model Context Protocol server that gives AI assistants native access to Minecraft mod development tools — decompile, remap, search, and analyze Minecraft source code directly from your AI workflow.
Updated 24 days ago (2026-10-21 01:45 UTC)
130 npm
50
MIT
modforge
Games & Gamification Developer Tools
champmk
A
license
Not graded
quality
C
maintenance
Provides deterministic, audit-chain-backed Minecraft symbol migration and version-truth queries over MCP for AI assistants, enabling grounded rename resolution and API diffs without hallucination.
Updated 5 months ago (2026-06-11 04:21 UTC)
24 npm
2
MIT
MC Source MCP Server
Code Analysis Games & Gamification
mnooseman
A
license
A
quality
D
maintenance
Enables exploration and decompilation of Minecraft source code, allowing users to list versions, search classes, and decompile .class files on-the-fly.
Updated 9 months ago (2026-02-05 15:42 UTC)
3
2
MIT
CNPC JavaDoc MCP Server
Documentation Access Developer Tools
SaltfishSheep
A
license
A
quality
D
maintenance
Enables AI agents to search CustomNPCs JavaDoc for methods, fields, and class hierarchies across multiple Minecraft versions and forks.
Updated 5 months ago (2026-06-27 14:28 UTC)
2
MIT

Native MC Mapping MCP Server

What It Does

Use Cases

MCP Tools

Quick Install (MCP Client)

Prerequisites

Step 1: Clone & Build

Step 2: Add to Your MCP Client

Usage

Tool Parameters

Supported Versions

How It Works

Output Format

Project Structure

License

Third-Party Data

Available Tools

Tool Schema Changelog

TDQS

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Minecraft Dev MCP

modforge

MC Source MCP Server

CNPC JavaDoc MCP Server