Skip to content
MCP server

Mc Pack Builder

MCP server for building, checking and exporting Minecraft modpacks with Modrinth lookups

Runs locallyStatus and history
Install
Pricing
Open source
Platforms
CLI, API, Windows
Runs
Locally
Version
1.1.0
Listing updated
today

Similar MCP servers

About Mc Pack Builder

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

The README describes this as a Model Context Protocol server that handles the bookkeeping of assembling a Minecraft modpack. It can scaffold a pack directory with its metadata files, read an existing pack's Minecraft version, loader and mod count, and search Modrinth for mods along with their version history and dependency chains.

Pack-level work is done locally: the server checks installed mods against a target Minecraft version for known conflicts, such as OptiFine under Fabric or Sodium alongside Embeddium, and can generate a full dependency list. Conflict rules live in an editable JSON file, so new pairs can be added without changing code. Export cleans out extra .minecraft files, unwraps nested zip bundles, writes an HTML or text modlist, and can split output into volumes of a set size.

The README says the local pack tools work offline, while search and info lookups need access to the Modrinth API, which can be pointed at a custom base URL. It is aimed at modpack authors who drive their workflow from an MCP-compatible AI client.

Install

Run in a terminal

claude mcp add mc-pack-builder -- npx -y mc-pack-builder-mcp

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

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

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

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

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

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

Tools this server provides (8)

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

create_pack
Create a new modpack directory structure (pack.mcmeta, version.txt, loader.txt, mods/)
get_pack_info
Read existing modpack metadata: MC version, loader, mod count, and common issues
search_mods
Search Modrinth for mods by keyword, returns ID, name, description, download count
get_mod_info
Get detailed info about a Modrinth mod: version history, dependencies, supported MC versions
resolve_dependencies
Recursively resolve a mod's full dependency chain (direct + indirect)
check_pack_compatibility
Check installed mods against a target MC version for known incompatibilities
generate_dependency_list
Generate a complete dependency list for all mods in an existing pack
export_standard_pack
Export a clean, distribution-ready modpack: cleanup extras, unwrap nested zips, generate modlist, optional volume splitting

What it does

Pack structure scaffolding
Creates a standard modpack directory with the metadata files and mods folder already in place.
Modrinth mod search
Searches Modrinth by keyword and returns mod IDs, descriptions and download counts.
Recursive dependency resolution
Follows a mod's direct and indirect dependencies to list everything it requires.
Known conflict detection
Flags mod pairs and loader-specific combinations that are known to clash for a target Minecraft version.
Distribution export
Cleans extra files, unwraps nested zips, generates a modlist and can split output into size-limited volumes.
Editable compatibility rules
Conflict and pack_format rules are stored in a JSON file that can be extended without code changes.

Good for

  • Scaffold a new Fabric or other loader modpack for a chosen Minecraft version
  • Check an existing modpack for mods that conflict with each other or with the target version
  • Find a mod on Modrinth and list everything it depends on before adding it
  • Generate a dependency list and modlist for a pack's documentation
  • Prepare a cleaned, split export of a modpack for download distribution

Pricing

Open source

Free and MIT licensed, run locally.

Mc Pack Builder FAQ

Do the local pack tools need an internet connection?

No. The README says all local pack tools work without network access, and only the search and info tools call Modrinth.

Can the Modrinth API address be changed?

Yes. The README lists an environment variable and a .env setting for the Modrinth API base URL, which can point to a self-hosted gateway or proxy.

How are compatibility rules updated?

The README says to edit src/pack-rules.json, or dist/pack-rules.json after building, to add or override incompatible pairs, loader rules and pack_format mappings.

What client setup is needed?

The server runs over stdio with Node.js 18+ and is added to an MCP client config as a command pointing to dist/index.js.

Is Mc Pack Builder free?

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

How do I add Mc Pack Builder to Claude Code?

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

What are the best alternatives to Mc Pack Builder?

The closest alternatives to Mc Pack Builder are Mc Modpack, Mc Changelog and Mc Rp Assistant.

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