MC ModdingSAFE
mcmodding-mcp is a Model Context Protocol (MCP) server that gives AI assistants like Claude direct access to Minecraft modding documentation. Instead of relying on potentially outdated training data, your AI assistant can search real documentation, find code examples, and explain concepts accurately
Overview
From the repository's own README, as read at the audited commit. Badges and raw HTML are left out.
🤖 AI-Powered Minecraft Modding Documentation Server
Give your AI assistant real-time access to Fabric & NeoForge documentation
[](https://www.npmjs.com/package/mcmodding-mcp) [](https://www.npmjs.com/package/mcmodding-mcp) [](https://opensource.org/licenses/MIT) [](https://github.com/OGMatrix/mcmodding-mcp/actions/workflows/ci.yml)
[](https://github.com/OGMatrix/mcmodding-mcp/stargazers) [](https://github.com/OGMatrix/mcmodding-mcp/issues) [](https://github.com/OGMatrix/mcmodding-mcp/commits) [](https://nodejs.org/)
📖 Documentation • 🚀 Quick Start • 💡 Features • 🤝 Contributing
✨ What is this?
MCModding-MCP is a Model Context Protocol (MCP) server that supercharges AI assistants like Claude with real, up-to-date Minecraft modding knowledge. No more ha
01ee09f94437OBSERVED · 2026-10-08Connect
Built from this server's own package name, version and transport as found in its source — not copied from anyone's documentation, so it cannot drift against a page we do not control. Replace the environment placeholders with a token scoped to the least it needs.
claude mcp add mcmodding-mcp --env GITHUB_TOKEN=${GITHUB_TOKEN} -- npx -y [email protected]{
"mcpServers": {
"mcmodding-mcp": {
"command": "npx",
"args": [
"-y",
"[email protected]"
],
"env": {
"GITHUB_TOKEN": "${GITHUB_TOKEN}"
}
}
}
}Exposed tools (15)
14 read · 1 write · 0 destructive.
| Tool | Risk | Description |
|---|---|---|
browse_package | read | Browse classes in a specific Minecraft package. Useful for discovering available classes in a package. |
explain_fabric_concept | read | Get detailed explanation of a Fabric or Minecraft modding concept. Use this to understand fundamental concepts, terminology, or architectural patterns. |
get_class_details | read | Get detailed information about a specific Minecraft class including all its methods and fields with their parameter names and Javadocs. |
get_example | read | Get code examples for Minecraft modding topics. Returns complete, working code snippets with full context including explanations, source documentation, and metadata. Use this when you need concrete code examples for implementing features. |
get_method_signature | read | Get the full signature of a specific method including parameter names, types, and Javadoc. Useful when you need to understand how to call or override a Minecraft method. |
get_minecraft_version | read | Get Minecraft version information from the indexed documentation. Returns either the latest version or all available versions. |
get_mod_example | read | Get detailed information about a specific mod example by ID. Returns full code, explanation, best practices, pitfalls, imports, and related examples. Use after searching to get complete details. |
get_mod_patterns | read | Get all available pattern types with counts. Useful for discovering specific implementation patterns. |
list_canonical_mods | read | List all indexed canonical mods with their example counts and descriptions. Use this to discover what mods are available for examples. |
list_mapping_versions | read | List all Minecraft versions available in the mappings database with statistics. |
list_mod_categories | read | List all available pattern categories with example counts. Use this to discover what types of examples are available. |
lookup_obfuscated | read | Look up the deobfuscated name for an obfuscated Minecraft class, method, or field name. Useful when encountering obfuscated names in crash logs or decompiled code. |
search_fabric_docs | read | Search Fabric modding documentation for guides and API information. Use this when you need to find documentation about Fabric modding features, APIs, or tutorials. |
search_mappings | read | Search Minecraft class, method, and field mappings from Parchment data. Returns deobfuscated names, parameter names, and Javadoc documentation. Use this when you need to understand Minecraft internals or find the correct class/method names for modding. |
search_mod_examples | write | Search through canonical code examples from popular open-source mods like Create, Botania, Applied Energistics 2. These are real-world, battle-tested implementations with AI-generated explanations. Use this when you need proven patterns from successful mods. |
Trust audit
SAFEgrade B · trust 89/100 Nothing in the source contradicts what it says it does. Grade A is reserved for packages that have also passed the behavioural sandbox.
| Layer | What it checks | Result |
|---|---|---|
| L0 | Provenance & inventory | PASS |
| L1 | Static analysis of the code | PASS |
| L2 | Instruction surface (what it tells the agent) | PASS |
| L3 | Class-specific surface | PASS |
| L4 | Behavioural (sandbox) | SKIPPED |
What the source does
- Filesystem
- declared (1 observation(s))
- Network
- declared (6 observation(s))
- Shell
- none-observed
- Dependencies
- not all pinned
- Secrets in source
- none-found
Findings (7)
.commitlintrc.json
.prettierignore
.prettierrc.json
.release-please-manifest.json
.releaserc.json
await fn(`http://127.0.0.1:${port}`);@modelcontextprotocol/sdk, @xenova/transformers, better-sqlite3, cheerio, jsonrepair, node-fetch, sharp, @commitlint/cli
Gates applied: no_behavioural_pass.
01ee09f94437full audit observations/trust-audit/mcp-server/ogmatrix__mc-modding.json · Report an issue / request a re-scanAudit history
Every audit this server has had. A grade with a past is a grade somebody is still checking.
| Date | Source | Verdict | Grade | Score | Change |
|---|---|---|---|---|---|
| 2026-10-08 | 01ee09f94437 | SAFE | B | 89 | first audit |
Questions
What is the MC Modding MCP server?
mcmodding-mcp is a Model Context Protocol (MCP) server that gives AI assistants like Claude direct access to Minecraft modding documentation. Instead of relying on potentially outdated training data, your AI assistant can search real documentation, find code examples, and explain concepts accurately
What tools does MC Modding expose?
15 in total: 14 read-only, 1 that write, and 0 that can delete or overwrite. Every one is listed on this page with its risk.
Is MC Modding safe to connect to an agent?
The audit found nothing in the source that contradicts what it says it does, and graded it B (89/100). Grade A is held back for packages that have also passed a sandboxed behavioural run, which is why a clean server reads B.
What credentials does MC Modding need?
It reads GITHUB_TOKEN from the environment. Give it a token scoped to the least it needs — an agent that can be talked into calling a tool can be talked into calling it with your credentials.
How does MC Modding run?
It speaks stdio, so it runs as a local process your client starts. It is published on npm as mcmodding-mcp at 0.4.5.
How current is this page?
The grade is for one exact copy of the source (01ee09f94437), read on 2026-10-08. The repository is watched and re-audited when it changes.