Mc Modpack
MCP server for diagnosing Minecraft modpacks: mod conflicts, logs and crash reports
- 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-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"mc-modpack": {
"command": "npx",
"args": [
"-y",
"mc-modpack-mcp"
]
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"mc-modpack": {
"command": "npx",
"args": [
"-y",
"mc-modpack-mcp"
]
}
}
}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.