Skip to main content
Glama
deenesjakoruzh
dcd887

mc-pack-builder-mcp

by dcd887
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

mc-pack-builder-mcp

Minecraft の modpack 構築のための MCP サーバー。パック構造の作成、Modrinth での MOD 検索、依存関係の解決、互換性のチェックを行います。

ツール

Tool

Description

create_pack

新しい modpack のディレクトリ構造を作成します (pack.mcmeta、version.txt、loader.txt、mods/)

get_pack_info

既存の modpack のメタデータを読み取ります: MC バージョン、ローダー、MOD 数、一般的な問題

search_mods

キーワードで Modrinth の MOD を検索し、ID、名前、説明、ダウンロード数を返します

get_mod_info

Modrinth の MOD の詳細情報を取得します: バージョン履歴、依存関係、対応 MC バージョン

resolve_dependencies

MOD の完全な依存チェーンを再帰的に解決します (直接 + 間接)

check_pack_compatibility

インストール済み MOD をターゲットの MC バージョンと照合し、既知の非互換性をチェックします

generate_dependency_list

既存のパック内のすべての MOD の完全な依存リストを生成します

Related MCP server: modrinth-mcp

機能

  • パック構造の作成 — 必要なファイルをすべて含む標準の modpack ディレクトリを生成します

  • Modrinth 連携 — Modrinth API から直接 MOD メタデータを検索・照会します

  • 依存関係の解決 — 完全な依存ツリーを辿り、すべての要件が満たされていることを確認します

  • 互換性チェック — 既知の競合 (例: OptiFine と Fabric、Sodium と Embeddium) を検出します

  • オフライン動作 — すべてのローカルパックツールはネットワークなしで動作します。検索・情報ツールのみ Modrinth が必要です

インストール

前提条件

  • Node.js 18+

  • npm

ビルド

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

スタンドアロン MCP サーバーとして実行

node dist/index.js

サーバーは stdio (JSON-RPC 2.0) を介して通信します。MCP 互換の任意のクライアントで利用できます。

MCP クライアントの設定

MCP クライアントの設定に追加します:

{
  "mcpServers": {
    "mc-pack-builder": {
      "command": "node",
      "args": ["<path/to/mc-pack-builder-mcp>/dist/index.js"]
    }
  }
}

使用例

新しい modpack を作成

{
  "name": "create_pack",
  "arguments": {
    "pack_dir": "/path/to/MyModpack",
    "name": "My Modpack",
    "mc_version": "1.20.1",
    "loader": "fabric"
  }
}

Modrinth で MOD を検索

{
  "name": "search_mods",
  "arguments": {
    "query": "sodium",
    "limit": 5
  }
}

依存関係を解決

{
  "name": "resolve_dependencies",
  "arguments": {
    "project_id": "geckolib"
  }
}

パックの互換性をチェック

{
  "name": "check_pack_compatibility",
  "arguments": {
    "pack_dir": "/path/to/MyModpack",
    "mc_version": "1.20.1"
  }
}

アーキテクチャ

mc-pack-builder-mcp/
├── src/
│   └── index.ts        # MCP server + all tool implementations
├── dist/               # Compiled JavaScript (output of tsc)
├── __tests__/
│   └── unit.test.ts    # Unit tests (offline)
├── package.json        # Node.js dependencies (@modelcontextprotocol/sdk, zod)
├── tsconfig.json       # TypeScript config (CommonJS output)
├── test.js             # Integration test runner
├── test_logs/          # Test output logs (gitignored)
└── .gitignore

MCP は公式の @modelcontextprotocol/sdk v1.x と McpServer、StdioServerTransport を使用します。

テスト

npm run build
node test.js

テストは os.tmpdir() の下に一時ディレクトリを作成し、終了後にクリーンアップします。Minecraft のインストールは不要です。

プラットフォーム互換性

Tool

Windows

macOS

Linux

create_pack

✅

✅

✅

get_pack_info

✅

✅

✅

search_mods

✅

✅

✅

get_mod_info

✅

✅

✅

resolve_dependencies

✅

✅

✅

check_pack_compatibility

✅

✅

✅

generate_dependency_list

✅

✅

✅

すべてのツールはクロスプラットフォームの Node.js fs および path API を使用します。ネットワーク依存のツール (search_mods、get_mod_info、resolve_dependencies) は、プラットフォームに関係なくインターネットアクセスが必要です。

ライセンス

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • modrinth-mcp

    justinscott12
    A
    license
    A
    quality
    A
    maintenance
    Enables AI agents to search, read, and publish Minecraft mods on Modrinth, including creating projects and uploading jar files as new versions.
    7
    19 npm
    MIT

  • mc-rp-assistant-mcp

    dcd887
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables reading, validating, and managing Minecraft resource packs, including structure checks, asset listing, pack comparison, and Modrinth queries.
    MIT

  • minecraft-mod-mcp-server

    dcd887
    A
    license
    Not graded
    quality
    B
    maintenance
    Enables Minecraft modpack development by generating FTB Quests chapters and tasks, KubeJS scripts (weapons, armor, recipes), validating SNBT/config files, and providing diagnostic checks.
    MIT