mc-mod-config

mc-mod-config-mcp

Minecraft の MOD 設定ファイルを管理する MCP サーバーです。Modpack の .cfg、.toml、.json 設定ファイルを読み込み、検証、比較し、クリーンアップします。

ツール

ツール	説明
read_mod_config	単一の設定ファイル（.cfg、.toml、.json）を解析し、問題があれば併せて構造化データとして返します
list_mod_configs	設定ディレクトリを再帰的にスキャンし、MOD ID、形式、サイズとともにすべての設定ファイルを一覧表示します
validate_mod_configs	空の値、無効な数値、解析エラー、長すぎる文字列など、よくある問題がないかすべての設定ファイルを検証します
compare_mod_configs	2つの設定ディレクトリ（Modpack の更新前後）を比較し、追加、削除、変更されたファイルを報告します
find_orphaned_configs	mods/ ディレクトリに対応する MOD の JAR が存在しない設定ファイルを探します
get_mod_default_config	人気の MOD（Sodium、OptiFine、Phosphor、Lithium、Fabric API）の既知のデフォルト／ベースライン設定を返します

対応する設定形式

形式	拡張子	ローダー
Forge の INI 形式	.cfg	Forge
Fabric TOML	.toml	Fabric
JSON	.json	任意

機能

• 複数形式の解析 — Forge の .cfg、Fabric の .toml、.json 設定ファイルをネイティブに処理します
• 検証エンジン — 空の値、無効な数値、解析エラー、長すぎる文字列を検出します
• 設定の比較 — Modpack の更新による変更を追跡できる、キー単位の差分を表示します
• 孤立ファイルの検出 — 設定ファイルを、インストール済みの MOD JAR および組み込みの既知の MOD データベースと照合します
• デフォルト設定 — 人気のパフォーマンス MOD 用に、動作確認済みのデフォルト設定を同梱しています
• 完全オフライン — ネットワーク通信は不要です。すべてのデータはローカルまたは組み込みです

インストール

前提条件

• Node.js 18+
• npm

ビルド

cd mc-mod-config-mcp
npm install
npm run build

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

node dist/index.js

サーバーは stdio（JSON-RPC 2.0）で通信します。MCP 対応のクライアントであれば利用できます。

MCP クライアントの設定

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

{
  "mcpServers": {
    "mc-mod-config": {
      "command": "node",
      "args": ["${MC_MOD_CONFIG_ROOT}/dist/index.js"]
    }
  }
}

パスに関する注意: ${MC_MOD_CONFIG_ROOT} を、このプロジェクトのルートディレクトリの絶対パスに置き換えてください。Windows ではスラッシュを使用してください：["C:/path/to/mc-mod-config-mcp/dist/index.js"]（C:/path/to/ を実際のパスに置き換えてください）。または、プロジェクトのルートを指す環境変数 MC_MOD_CONFIG_ROOT を設定し、設定ファイル内でこの変数を使用してください。

設定

このツールは設定不要で使えます（デフォルト値が組み込まれており、どの環境でもすぐに使用できます）。以下の項目は環境変数またはプロジェクトルートの .env ファイルで上書きできます（.env.example を .env にコピーしてください）。

変数	デフォルト値	説明
MOD_CONFIG_EXTENSIONS	cfg,toml,json	スキャン／解析に対応する設定ファイルの拡張子（カンマ区切り。カスタム拡張子を追加できます）
MOD_CONFIG_MAX_FILE_MB	50	設定ファイル1つあたりの最大サイズ（MB）。超過したファイルはスキップされます
MOD_CONFIG_MAX_STRING_LEN	500	検証時に文字列値の長さに対して警告するしきい値

既知の MOD のデフォルト設定ライブラリを拡張する：src/mod-defaults.json（ビルド後は dist/mod-defaults.json）を編集し、defaults の下に MOD を追加／上書きします。コードの変更は不要です。たとえば、"iris": { "name": "Iris", "fallbackConfig": { "enableShaders": true } } を追加します。

優先順位：環境変数 > .env ファイル > 組み込みのデフォルト値。変更を反映するには MCP サーバーを再起動してください。

使用例

設定ファイルを読み込む

{
  "name": "read_mod_config",
  "arguments": {
    "configPath": "/path/to/mods/sodium/sodium.toml"
  }
}

Modpack 内のすべての設定ファイルを一覧表示する

{
  "name": "list_mod_configs",
  "arguments": {
    "configDir": "/path/to/modpack/config"
  }
}

設定ファイルの問題を検証する

{
  "name": "validate_mod_configs",
  "arguments": {
    "configDir": "/path/to/modpack/config"
  }
}

更新前後の設定ファイルを比較する

{
  "name": "compare_mod_configs",
  "arguments": {
    "oldConfigDir": "/path/to/old-modpack/config",
    "newConfigDir": "/path/to/new-modpack/config"
  }
}

孤立した設定ファイルを探す

{
  "name": "find_orphaned_configs",
  "arguments": {
    "modsDir": "/path/to/modpack/mods",
    "configDir": "/path/to/modpack/config"
  }
}

MOD のデフォルト設定を取得する

{
  "name": "get_mod_default_config",
  "arguments": {
    "modId": "sodium"
  }
}

アーキテクチャ

mc-mod-config-mcp/
├── src/
│   └── index.ts        # MCP server + all tool implementations
├── dist/               # Compiled JavaScript (output of tsc)
├── skills/
│   └── mc-mod-config-helper.md  # Trae Work skill for config management
├── __tests__/
│   └── unit.test.ts    # Unit tests (fully offline)
├── package.json        # Node.js dependencies (@modelcontextprotocol/sdk, zod)
├── tsconfig.json       # TypeScript config (CommonJS output)
└── .gitignore

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

テスト

npm run build
npm test

すべての単体テストは完全オフラインで実行でき、Minecraft のインストールは不要です。

プラットフォーム互換性

ツール	Windows	macOS	Linux
read_mod_config	✅	✅	✅
list_mod_configs	✅	✅	✅
validate_mod_configs	✅	✅	✅
compare_mod_configs	✅	✅	✅
find_orphaned_configs	✅	✅	✅
get_mod_default_config	✅	✅	✅

すべてのツールは、クロスプラットフォーム対応の Node.js fs および path API を使用します。処理前に、すべてのパスを絶対パスとして解決します。Forge の .cfg パーサーはセクション、型の検出、引用符で囲まれた値を処理し、Fabric の .toml パーサーはネストされたテーブルと配列を処理します。

ライセンス

MIT