@adhisang/minecraft-modding-mcp
Installed, started with no arguments, no environment and no input, and listed its tools. Run 2026-11-16.
Needs to start: nothing
Returns a result when called with no setup: 2 of 3 tools tried
Contacts while installing and starting: nothing
What it contacted
Nothing besides the npm registry it was installed from. Watched from outside its sandbox while it was installed and started with no input. Its tools may still contact things when called.
Starting it
npx -y @adhisang/minecraft-modding-mcp@8.2.0
Installing a package runs its code. Use a sandbox for anything you have not read.
Calling its tools
3 tools that take no input and look read-only were called once with nothing. 2 returned a result.
list-versions | Returned a result 0.1 s · 925 characters |
list-artifact-files | No usable answer tool reported an error: {"error":{"type":"https://minecraft-modding-mcp.dev/problems/invalid-input","title":"Invalid input","detail":"Request validation failed. |
get-runtime-metrics | Returned a result under 0.1 s · 1,966 characters |
During the calls (not necessarily because of them) it first contacted: piston-meta.mojang.com.
Only tools whose names read like looking something up, with no required input, are tried, five at most. Tools that need input, and anything that sounds like it changes or sends something, are not called.
What its tools tell an agent
In the tool descriptions, nothing that talks about the user, other tools or private files, or uses hidden characters.
Found by simple pattern rules in each tool's description (up to 3,000 characters), quoted as written. Parameter descriptions are not scanned. A clean result is not a safety review.
Tools
list-versions includeSnapshots, limit
List available Minecraft versions from Mojang manifest and locally cached version jars. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
inspect-minecraft task, subject, includeSnapshots, detail, include, limit, cursor
Top-level workflow tool for version discovery, artifact resolution, class inspection, source search, file reads, and file listings. Workspace subject.focus is a structured class/file/search object, never a string; task=auto dispatches from subject.kind and focus.kind.
analyze-symbol task, subject, version, fromVersion, toVersion, maxVersions, includeTimeline, includeSnapshots, sourceMapping, targetMapping, classNameMapping, projectPath, gradleUserHome, signatureMode, nameMode, includeKinds, maxRows, maxCandidates, detail, include
Top-level workflow tool for symbol existence, mapping, lifecycle, workspace analysis, and API overview. subject.kind='symbol' auto-detects class/field/method from the selector.
compare-minecraft task, subject, detail, include, limit, maxClassResults, maxEntriesPerRegistry, includeFullDiff
Top-level workflow tool for version comparisons, class diffs, registry diffs, and migration overviews.
analyze-mod task, subject, query, searchType, limit, includeFiles, maxFiles, maxLines, maxChars, targetMapping, outputJar, executionMode, detail, include
Top-level workflow tool for mod metadata inspection, decompile/search flows, class source, bytecode-only class member reads, and safe remap previews/applies.
36 more tools
validate-project task, subject, version, mapping, atNamespace, sourcePriority, scope, preferProjectVersion, preferProjectMapping, detail, include, sourceRoots, configPaths, minSeverity, hideUncertain, explain, warningMode, warningCategoryFilter, treatInfoAsWarning, includeIssues, reportMode
Top-level workflow tool for project summary, direct mixin validation, and access widener/access transformer validation.
manage-cache action, cacheKinds, selector, detail, include, limit, cursor, executionMode
Top-level workflow tool for cache summaries, listing, verification, previewed mutation, and explicit apply operations.
verify-mixin-target owner, member, mixinMemberName, mapping, autoRemap, sourcePriority, projectPath, gradleUserHome, target, scope, preferProjectVersion, strictVersion
Single-call probe: does this target owner / member exist and which @Shadow / @Accessor / @Invoker should the mixin use? Reuses target.kind workspace/version/coordinate/dependency/jar.
batch-class-source target, mapping, sourcePriority, allowDecompile, projectPath, gradleUserHome, scope, preferProjectVersion, strictVersion, concurrency, failFast, detail, include, entries
Batch get-class-source for many classes sharing one resolved artifact; returns per-entry status plus aggregate summary. Not read-only: per-entry outputFile writes to disk.
batch-class-members target, mapping, sourcePriority, allowDecompile, projectPath, gradleUserHome, scope, preferProjectVersion, strictVersion, concurrency, failFast, detail, projection, include, entries
Batch get-class-members for many classes sharing one resolved artifact; returns per-entry status plus aggregate summary.
batch-symbol-exists target, mapping, sourcePriority, allowDecompile, projectPath, gradleUserHome, scope, preferProjectVersion, strictVersion, concurrency, failFast, detail, include, entries
Batch check-symbol-exists for many symbols against one shared Minecraft version (target.kind=version or workspace only).
batch-mappings version, sourcePriority, projectPath, gradleUserHome, concurrency, failFast, detail, include, entries
Batch find-mapping: resolve many symbols across mapping namespaces with one shared Minecraft version.
resolve-artifact target, mapping, sourcePriority, allowDecompile, projectPath, gradleUserHome, scope, preferProjectVersion, strictVersion, detail, include
Resolve a source artifact and return artifact metadata. For target.kind=jar, only <basename>-sources.jar is auto-adopted. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
find-class className, artifactId, target, projectPath, limit
Resolve a simple or qualified class name to fully-qualified class names within an artifact. Use this before get-class-source when you only have a simple name. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
get-class-source className, mode, target, mapping, sourcePriority, allowDecompile, projectPath, gradleUserHome, scope, preferProjectVersion, strictVersion, startLine, endLine, maxLines, maxChars, outputFile, detail, include, includeProvenance
Get Java source for a class. Default mode=metadata returns a symbol outline only; pass mode=snippet or mode=full to read source text. Not read-only: outputFile writes to disk. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
get-class-members className, target, mapping, sourcePriority, allowDecompile, access, includeSynthetic, includeInherited, includeAnnotations, memberPattern, projection, maxMembers, cursor, projectPath, gradleUserHome, scope, preferProjectVersion, strictVersion, detail, include, includeProvenance, includeDescriptors
Get fields/methods/constructors for one class from binary bytecode. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
search-class-source artifactId, target, projectPath, query, intent, match, packagePrefix, fileGlob, symbolKind, queryMode, limit, cursor, queryNamespace, sourcePriority, gradleUserHome, detail, include
Search indexed class source files for one artifact with symbol/text/path intent and compact hit output. Decompiled text can differ from hand-written code (`final` parameters, `@Nullable` between modifiers and type, wrapped declarations), so search for a method by its name or with intent `symbol`, not by its full declaration. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
get-artifact-file artifactId, target, projectPath, filePath, maxBytes
Get full source file content by artifactId and file path. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
list-artifact-files artifactId, target, projectPath, prefix, limit, cursor, detail, include
List source file paths in an artifact with optional prefix filter and cursor-based pagination. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
trace-symbol-lifecycle symbol, descriptor, fromVersion, toVersion, mapping, sourcePriority, gradleUserHome, includeSnapshots, maxVersions, includeTimeline
Trace which Minecraft versions contain a specific class method and report first/last seen versions. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
diff-class-signatures className, fromVersion, toVersion, mapping, sourcePriority, gradleUserHome, includeFullDiff
Compare one class signature between two Minecraft versions and report added/removed/modified constructors, methods, and fields. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
find-mapping version, kind, name, owner, descriptor, sourceMapping, targetMapping, sourcePriority, gradleUserHome, nameMode, signatureMode, disambiguation, maxCandidates, detail, include
Find symbol mapping candidates between namespaces using structured symbol inputs for a specific Minecraft version. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
resolve-method-mapping-exact version, name, owner, descriptor, sourceMapping, targetMapping, sourcePriority, gradleUserHome, maxCandidates, detail, include
Strict variant of find-mapping(kind=method, signatureMode=exact): requires a COMPLETE descriptor projection and returns mapping_unavailable when any descriptor class reference cannot be projected. Prefer find-mapping unless you need that guarantee. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
get-class-api-matrix version, className, classNameMapping, includeKinds, sourcePriority, gradleUserHome, maxRows, cursor
List class/member API rows across obfuscated/mojang/intermediary/yarn mappings for one class and Minecraft version. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
resolve-workspace-symbol projectPath, version, kind, name, owner, descriptor, sourceMapping, sourcePriority, gradleUserHome, maxCandidates, detail, include
Resolve class/field/method names as seen at compile time for a workspace by reading Gradle Loom mapping settings. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
check-symbol-exists version, kind, owner, name, descriptor, sourceMapping, sourcePriority, gradleUserHome, nameMode, signatureMode, maxCandidates, detail, include
Check whether a class/field/method symbol exists in a specific mapping namespace for one Minecraft version. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
nbt-to-json nbtBase64, compression
Decode Java Edition NBT binary payload (base64) into typed JSON.
nbt-apply-json-patch typedJson, patch
Apply RFC6902 add/remove/replace/test operations to typed NBT JSON.
json-to-nbt typedJson, compression
Encode typed NBT JSON to Java Edition NBT binary payload (base64).
index-artifact artifactId, target, projectPath, force
Rebuild indexed files/symbols metadata for an artifact addressed by artifactId or target. A new target is resolved and ingested first; force rebuilds an existing index. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
get-runtime-metrics
Get runtime service counters and latency snapshots for cache/search/index diagnostics.
validate-mixin input, sourceRoots, version, mapping, sourcePriority, scope, projectPath, gradleUserHome, preferProjectVersion, minSeverity, hideUncertain, explain, warningMode, preferProjectMapping, reportMode, warningCategoryFilter, treatInfoAsWarning, includeIssues
Validate Mixin source against Minecraft bytecode signatures for a given version. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
validate-access-widener content, version, mapping, sourcePriority, projectPath, gradleUserHome, scope, preferProjectVersion
Validate Access Widener file entries against Minecraft bytecode signatures for a given version. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
validate-access-transformer content, version, atNamespace, sourcePriority, projectPath, gradleUserHome, scope, preferProjectVersion
Validate Access Transformer file entries against Minecraft bytecode signatures for a given version. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
analyze-mod-jar jarPath, includeClasses
Analyze a Minecraft mod JAR to extract loader type, metadata, entrypoints, mixins, and dependencies. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
get-registry-data version, registry, includeData, maxEntriesPerRegistry
Get Minecraft registry data (blocks, items, biomes, etc.) for a specific version by running the server data generator.
compare-versions fromVersion, toVersion, category, packageFilter, maxClassResults
Compare two Minecraft versions to find added/removed classes and registry entry changes. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
decompile-mod-jar jarPath, className, includeFiles, maxFiles
Decompile a Minecraft mod JAR using Vineflower and list available classes, or view a specific class source. Builds on analyze-mod-jar. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
get-mod-class-source jarPath, className, maxLines, maxChars, outputFile
Get decompiled source code for a specific class in a mod JAR. The mod JAR will be decompiled if not already cached. Not read-only: outputFile writes the source to disk. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
search-mod-source jarPath, query, searchType, limit
Search through decompiled mod JAR source code by class name, method, field, or content pattern. The mod JAR will be decompiled automatically if not already cached. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
remap-mod-jar inputJar, outputJar, mcVersion, targetMapping, forceRemap
Remap a Fabric mod JAR from intermediary to yarn/mojang names. Requires Java to be installed. Expert tool: prefer the entry tools (inspect-minecraft, analyze-symbol, compare-minecraft, analyze-mod, validate-project) first.
Descriptions are the package's own words, cut at 3,000 characters. Treat them as data.
Files it wrote
/tmp/ .cache/ minecraft-modding-mcp/ source-cache.db /tmp/ .cache/ minecraft-modding-mcp/ source-cache.db-wal /tmp/ .cache/ minecraft-modding-mcp/ source-cache.db-shm
Paths inside its sandbox, where its home folder is /tmp and its own folder cannot be written to.
Install facts
| License | MIT |
|---|---|
| Needs | node >=22.13.0 |
| Source | github.com/adhi-jp/minecraft-modding-mcp |
| Install scripts | None declared by it or anything installed with it. |
| Tarball | sha512-BynJAEb2zdn0cqZe0hPkLc3V+0AejLFd5/B1DAWWBe04yewO52nHMYeItYwJ/m/JWbHeXpTf0aZ9MKt7Hk//EA== |
Check this report yourself
This site did not write the report. A public job on a GitHub-hosted machine did: the run, from this commit of the open-source runner. GitHub signed a token that names that job and the hash of the report, so any edit since would show.
Report as JSONExact text and tokenHow to verify it
Show it on your README
[](https://bragproof.smaverk.com/r/%40adhisang/minecraft-modding-mcp)
New version out? Ask for a fresh report.