Skip to content
MCP server

Mc Modpack

MCP server for diagnosing Minecraft modpacks: mod conflicts, logs and crash reports

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, self-hosted, Windows
Runs
Locally
Version
1.3.0
Listing updated
today

Similar MCP servers

About Mc Modpack

Mc Modpack is an open-source MCP server. It runs locally on your machine and is started by your AI client.

The README says this server gives AI clients a set of diagnostic tools for Minecraft modpacks running on Fabric or Forge. It reads instance metadata, the mods folder, latest.log and crash reports, then flags known problematic mod combinations and suggests replacements. Conflict and crash rules live in an external rules.json file, so they can be extended without changing code.

Most tools run offline against a local .minecraft directory and work on Windows, macOS and Linux. The exception is Java runtime detection, which depends on the PCL launcher config and only works on Windows. Dependency lookups query the Modrinth API, and an optional AI diagnosis tool calls the DashScope (Qwen) API, which needs an API key.

It is aimed at modpack authors and players troubleshooting crashes, and it also ships a CLI mode that runs the same diagnosis from a terminal without an MCP client.

Install

Run in a terminal

claude mcp add mc-modpack -- npx -y mc-modpack-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mc-modpack": {
      "command": "npx",
      "args": [
        "-y",
        "mc-modpack-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mc-modpack": {
      "command": "npx",
      "args": [
        "-y",
        "mc-modpack-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mc-modpack": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mc-modpack-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mc-modpack": {
      "command": "npx",
      "args": [
        "-y",
        "mc-modpack-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mc-modpack": {
      "command": "npx",
      "args": [
        "-y",
        "mc-modpack-mcp"
      ]
    }
  }
}

Using several servers? Build one config file with the MCP config generator.

Tools this server provides (11)

Taken from the project documentation; the running server may differ.

get_java_versions
List all Java runtimes from PCL config
get_version_info
Read instance metadata (version, loader, Java, JVM args, mod count)
list_mods
Scan mods/ directory, optionally filter by regex
detect_conflicts
Detect known mod conflicts with auto-replacement recommendations
scan_cleanliness
Find non-JAR files, source jars, scripts in mods/
read_log
Read latest.log with level/keyword/tail filtering
find_crash_reports
List all crash reports in crash-reports/
analyze_crash
Parse a crash report, extract exception type and summary
check_mod_dependencies
Query Modrinth API for mod deps and compatibility
get_replacement_recommendations
Get replacement mod suggestions for known conflicts
ai_diagnose
AI-powered full diagnostics report using Qwen (requires DASHSCOPE_API_KEY)

What it does

Mod conflict detection
Matches installed mods against known problematic combinations and recommends replacements.
Log and crash analysis
Filters latest.log by level or keyword and classifies crash reports with suggested fixes.
Mods folder cleanup scan
Finds non-JAR files, source jars and scripts left in the mods directory.
Instance metadata reading
Extracts Minecraft version, loader, Java requirements and JVM arguments from an instance.
Modrinth dependency lookup
Queries the Modrinth API for a mod's version and dependency compatibility.
Editable rules engine
Conflict, Java version and crash patterns are defined in a JSON file that can be edited.
Terminal diagnosis mode
An npm script runs an interactive diagnosis without an MCP client.

Good for

  • Finding which mods in a Fabric or Forge pack are causing a crash
  • Checking a modpack for leftover non-JAR files before release
  • Looking up mod dependencies and loader compatibility on Modrinth
  • Reviewing WARN and ERROR lines in latest.log without opening the full file
  • Choosing a Java runtime that matches a given Minecraft version

Pricing

Open source

Free and MIT licensed; optional AI analysis uses a paid DashScope API key.

Mc Modpack FAQ

Which operating systems are supported?

Most tools are cross-platform. The README says get_java_versions works only on Windows with the PCL launcher, and macOS and Linux users must pass mc_dir explicitly.

Does it need an API key?

Only the ai_diagnose tool needs DASHSCOPE_API_KEY. The core diagnostic engine runs offline.

How is it installed?

Clone the repository, run npm install and npm run build, then point an MCP client at dist/index.js over stdio.

Can I add new conflict rules?

Yes. The README says conflicts, Java version mappings and crash patterns are edited in src/rules.json without changing code.

Is Mc Modpack free?

Yes. Mc Modpack is open source, so you can use and self-host it for free.

How do I add Mc Modpack to Claude Code?

Run this command in your terminal: claude mcp add mc-modpack -- npx -y mc-modpack-mcp

Where this comes from

  • Description: written from the project's README and its MCP Registry entry.
  • Install steps: from the official MCP Registry entry.

How AIPoweredBot checks servers