mc-pack-builder-mcp

MCP server for Minecraft modpack building. Creates pack structures, searches mods on Modrinth, resolves dependencies, checks compatibility, and exports standardized modpacks ready for distribution.

Tools

Features

• Pack structure creation — generates standard modpack directory with all required files
• Modrinth integration — search and query mod metadata directly from the Modrinth API
• Dependency resolution — follows the full dependency tree to ensure all requirements are met
• Compatibility checking — detects known conflicts (e.g. OptiFine with Fabric, Sodium vs Embeddium)
• Export standard pack — automatically cleans .minecraft extras, unwraps nested zip bundles, generates a styled modlist.html or plain modlist.txt, and optionally splits large packs into ≤256 MB volumes for easy distribution
• Offline operation — all local pack tools work without network; only search/info tools need Modrinth

Installation

Prerequisites

• Node.js 18+
• npm

Build

cd mc-pack-builder-mcp
npm install
npm run build

Run as standalone MCP server

node dist/index.js

The server communicates via stdio (JSON-RPC 2.0). It can be consumed by any MCP-compatible client.

Configuration for MCP clients

Add to your MCP client config:

{
  "mcpServers": {
    "mc-pack-builder": {
      "command": "node",
      "args": ["${MC_PACK_BUILDER_ROOT}/dist/index.js"]
    }
  }
}

Path note: Replace ${MC_PACK_BUILDER_ROOT} with the absolute path to this project's root directory. On Windows, use forward slashes: ["C:/Users/xxx/Desktop/mc-pack-builder-mcp/dist/index.js"]. Alternatively, set an environment variable MC_PACK_BUILDER_ROOT pointing to the project root and use the variable in the config.

Configuration

本工具零配置即可用（内置默认值，任何环境开箱即用）。以下项目可通过环境变量或项目根目录 .env 文件覆盖（复制 .env.example 为 .env）：

优先级：环境变量 > .env 文件 > 内置默认值。改动后重启 MCP server 生效。

扩展兼容性规则：编辑 src/pack-rules.json（构建后为 dist/pack-rules.json），新增/覆盖规则即可，无需改代码。

• rules.incompatible_pairs：互斥模组对，如 { "mods": ["sodium", "embeddium"], "reason": "..." }，当同一整合包同时出现 ≥2 个名单内模组时告警。
• rules.loader_incompatible：加载器专属不兼容，如 { "loader": "fabric", "mods": ["optifine"], "reason": "..." }。
• rules.pack_format：MC 版本 → pack.mcmeta 的 pack_format 数字映射（create_pack 默认取值）。

Usage Examples

Create a new modpack

{
  "name": "create_pack",
  "arguments": {
    "pack_dir": "/path/to/MyModpack",

... [View full README on GitHub](https://github.com/dcd887/mc-pack-builder-mcp#readme)