# Mc Pack Builder

> Mc Pack Builder is an open-source MCP server. MCP server for building, checking and exporting Minecraft modpacks with Modrinth lookups. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, API, Windows, macOS, Linux
- **Repository:** https://github.com/dcd887/mc-pack-builder-mcp
- **MCP Registry name:** io.github.dcd887/mc-pack-builder
- **Listing updated:** 2026-11-18

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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.

## Alternatives

- [Mc Modpack](https://ai-powered.com/mcp/mc-modpack): Mc Modpack is an open-source MCP server.
- [Mc Changelog](https://ai-powered.com/mcp/mc-changelog): Mc Changelog is an open-source MCP server for developer tools.
- [Mc Rp Assistant](https://ai-powered.com/mcp/mc-rp-assistant): Mc Rp Assistant is an open-source MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/mc-pack-builder
