ModWrench

ModWrench

AI アシスタントを Mod プラットフォームや独自の Mod 環境に接続する MCP サーバーです。Web UI をクリックして回る代わりに、AI クライアントで質問できます。

お使いのマシン上で動作します。アカウントも、サービスも、誰かが運用するサーバーも必要ありません。

ウェブサイト modwrench.171county.workers.dev は静的ページです。その お試しセクション では、ModWrench 自身のコードを使って、クラッシュログを読み取ったり、ブラウザー内でクルーリストを比較したりできます。何も送信されません（仕組み）。

---

クラッシュログを貼り付ければ、原因となった Mod がわかります。

SomeArmorMod.esp が疑わしい Mod として挙げられ、コールスタックのフレーム 2 には SomeArmorMod.dll が表示されています。ModWrench はログを解析し、その内容を整理して表示しました。原因を判断したわけではありません。判断するのはモデルの役割であり、そのことはページにも記載されています。

接続しているすべてのプラットフォームを検索でき、各行に作者が表示されます。

これらはウェブサイトのスクリーンショットではありません。それぞれが MCP Apps ページです。 外部スクリプト、スタイルシート、フェッチ、画像を含まない、自己完結型の HTML ドキュメントです。どのツールも、あらゆるクライアントが表示でき、モデルが読み取れるテキストで応答します。クラッシュログ、Mod リスト、依存関係とロード順、既知の競合、デッキ、Patch Day、Crash Whisperer、Doctors にもページがあります。これらのページが描画されるのは、MCP Apps に対応したクライアントだけです。ツールがページを指定すると、クライアントがそれを取得して描画し、ページが描画するデータは構造化データとして回答とともに届きます。ページを描画できないクライアントはページを取得せず、そのデータも送信されないため、テキストの回答だけが届き、HTML は一切送信されません。上の画像は、MCP Apps ホストの代替環境で描画したものです。その後、Windows 11 では、Crash Whisperer のページが Claude Desktop（Claude 自身が呼び出したもの）と MCP Inspector で動作し、デッキのページも MCP Inspector で動作しました。その他のページは、実際のクライアントではまだ試していません。

Patch Day、Crash Whisperer、Doctors（mw_patch_day、mw_crash_whisperer、 mw_doctor）はテキストを数行に抑え、完全なレポートはページに表示します。構造化データを送るのは、ページを描画できると表明したクライアントだけです。クライアントによっては、テキストの代わりに構造化データをモデルに渡すため、10 行の回答が長文になってしまうことがあるためです。それでも必要な場合、スクリプトやデータを読み取るエージェント向けに、MODWRENCH_STRUCTURED=always を設定してください。MODWRENCH_STRUCTURED=never を設定すると、誰にも送信されません。その場合、データがなければページにはテキストの回答を繰り返すことしかできないため、どのツールもページを指定しません。MODWRENCH_UI=off を設定すると、ページがすべて無効になり、構造化データも送信されなくなります。ただし、MODWRENCH_STRUCTURED=always で送信を要求した場合は除きます。ページはネットワーク要求を行わず、何も保持しません。TRUST.md と その他のページ に、ページでできることとできないことを記載しています。 オプションの HTTP サーバーである @modwrench/remote も同じように判断します。クライアントごとにセッションを保持するため（メモリ内のみで、何も書き込まず、24 時間使われなかったセッションは閉じられます）、ツール呼び出しに応答するサーバーは、クライアントがページを表示するかどうかを把握しています。そのため、Thunderstore の MOD 一覧と依存関係ツールは、ページを表示するクライアントにのみページのデータを送信します。セッションが閉じられたクライアントには、再接続するまで「Session not found」と表示されます。

Doctor（mw_doctor または /mw-doctor）は「セットアップの準備はできていますか？」に答えます。MOD のサポートで厄介なのは、よくある「MOD がいつも壊れる」というスレッドの原因が、MOD ではないことです。Setup Doctor は、ゲーム、Mod Organizer 2、Vortex のステージングフォルダーがどこにあるか（Program Files、OneDrive、その他 Windows が保護または同期するフォルダー）、Vortex のステージングフォルダーがハードリンクに必要なゲームと同じドライブ上にあるか、ドライブの空き容量を調べます。また、Skyrim Special Edition と Fallout 4 については、プラグインリストも確認します。マスターが見つからない、無効になっている、または読み込み順が遅すぎるプラグイン、上限であるフルプラグイン 254 個とライトプラグイン 4,096 個（ライトプラグインが有効になっていない Fallout 4 のリストではフルプラグイン 255 個）、削除済みプラグインのエントリ、Mod Organizer 2 とゲーム本体のリストの不一致、MO2 の Overwrite フォルダー内の不要なファイル、クラッシュログ記録ツール（存在しない、または互いに競合する 2 つのツール）を調べます。Linux と Steam Deck 向けの Deck Doctor は、ゲームをどの Steam が管理しているか（通常版か Flatpak 版か）、Proton がゲームのプレフィックスを作成しているか、BepInEx の winhttp 起動オーバーライド、nxm:// リンクを開くアプリ、ライブラリが NTFS、FAT32、exFAT のいずれかのドライブにあるか、大文字小文字だけが異なるフォルダー名を調べます。各指摘には、その根拠（お使いのファイル、出典を明記した文書化済みのルール、または ModWrench 独自の推測）が示されます。また、レポートには確認できない項目として、ウイルス対策ソフト、ページファイル、実行中に MO2 の仮想ファイルシステムがゲームに表示する内容が記載されます。ゲームがクラッシュした理由を調べるのは Crash Whisperer の役割であり、レポートにもその旨が記載されます。読み取り専用でローカルに動作し、ネットワーク通信もプログラムの起動も書き込みも行わず、回答にフォルダーパスを含めません。問題がないというレポートは、ファイルから実行できるチェックに合格したという意味です。ゲームが起動するという意味ではなく、その旨も記載されます。各ツールのドキュメントを基に作成され、構築したインストール環境でテストされていますが、実環境では実行されていません。TRUST.md には、確認する項目と不確かな点が記載されています。 クラッシュの原因を解き明かす（mw_crash_whisperer、または /mw-crash）は、「ゲームがクラッシュしたのはなぜ？」という質問に答えます。それ以外は何も言わずに尋ねると、ロガーが書き込んだ最新のクラッシュログ（または指定したログや貼り付けたログ）を読み、何が起きたのかをわかりやすく説明します。また、ログに記載された名前を、理由と、その理由の根拠がログ、ファイル、公表されたルール、ModWrench 独自の推測のどれなのかを示すラベルとともに、可能性の高い順に並べます。よくある原因がないか環境を確認し、ほかの最近の Crash Logger SSE と Buffout 4 のクラッシュログと比較して、同じ名前が繰り返し出てくるかどうかを調べます。さらに、フォーラム、GitHub、Discord に投稿したり、Mod の作者に送ったりするための投稿文を作成します。その際、認識できる個人情報（名前、コンピューター名、フォルダー、アドレス、キー）は取り除きます。これはパターンマッチングなので、見落としがある場合もあります。送信する前に投稿文を確認してください。投稿文にはコールスタックのほか、ログに記載された情報も含まれます。ロガーが一覧にしたオブジェクトと、それらを変更したプラグイン、ゲームファイル、レジスターとスタックに記載された Papyrus 関数とオブジェクト型、NetScriptFramework ログの DLL 一覧、BepInEx、Unity、各プラグインのバージョンです。ログにプラグイン一覧がない場合、またはロガーが一覧を書き込めなかった場合は、その旨を投稿文に記載します。ロガーが書き込めなかった場合は、ロード順用の欄を空白にします。ランキングは手掛かりであり、断定ではありません。また、何かを安全だと判断することもありません。ログから、ゲームが何を使って動作していたか（ログに記載されたオブジェクト、ゲームファイル、レジスター内のオブジェクトの種類、Papyrus 関数）を説明します。ゲームが RaceMenu や JContainers など、ほかの Mod も必要とするライブラリ内で停止した場合は、そのライブラリを削除しないよう伝え、ログに記載があれば、ライブラリを呼び出した可能性のある Mod を示します。目立った名前がない場合は、クラッシュログに記載されないこともある環境の問題を確認する Doctors を提案します。Crash Logger SSE、Buffout 4、NetScriptFramework、BepInEx のログを読み取ります。環境チェックは現時点では Skyrim Special Edition に対応しています。ディスク上のログを読み取らせる方法が、プライバシーを守る使い方です。認識された情報は、AI に送られる前に取り除かれます。チャットに貼り付けたログや入力したパスは、入力した時点ですでに AI に送られています。また、ログファイル自体が加工されることはありません。そのため、ファイルではなくヘルプ投稿を共有してください。 TRUST.mdには、検出できないものをわかりやすくまとめた一覧など、詳細が記載されています。

---

できること

4つのアタッチメント。1つでも、いくつかでも、すべてでもインストールできます。@modwrench/cli が、設定したアタッチメントをまとめて1つのMCPエントリーにします。

Nexus Mods — MODを検索し、変更履歴やファイル一覧を読み、バージョンを確認し、人気上昇中や最近更新されたMODを閲覧できます。ダウンロード前にアーカイブの内容をプレビューしたり、MD5でファイルを逆引きしたり、頼めばMODを推薦したりできます。（ツール15個）

mod.io — mod.ioが対応するゲーム全体からMODを検索・閲覧できます。MODの詳細、ファイル、タグ、統計、依存関係、コメントを取得できます。（ツール17個）

Thunderstore — コミュニティを閲覧し、MODを検索し、バージョン履歴をすべて読み、依存関係ツリーを解決できます。認証情報は不要です。読み取りAPIは公開されています。（ツール9個）

Workbench — お使いのマシン上でローカルに動作します。インストール済みのゲーム、MODマネージャー、ローダーを見つけ、MO2、r2modman、Vortexのロード順を読み取れます。Crash Logger SSE、Buffout 4、NetScriptFramework、BepInExのクラッシュログを解析したり、何が起きたか、ログがどの名前を指しているか、その確度はどの程度かを説明させたり、コピーしてすぐ使えるヘルプ投稿を作成したりできます。複数のプラットフォームでMODを検索し、既知の競合を確認できます。ゲームのパッチ適用前後に、スクリプトエクステンダーのプラグインが更新後も動作するか（Skyrim Special EditionとAnniversary EditionではSKSE、Fallout 4ではF4SE）を確認できます。また、Doctorsを実行して、クラッシュの背景にある環境を読み取り専用で診断できます（プラグインのマスターと上限、各種ファイルの場所、MO2のOverwriteフォルダー、さらにLinuxとSteam DeckではSteam、Proton、nxm:// 関連）。Skyrim Special EditionとFallout 4では、LOOTのマスターリストに基づき、有効なプラグインが必要とするファイルが存在するかだけを確認できます。さらにPulseを実行すると、r2modmanプロファイル内のThunderstore MODについて、更新の有無、非推奨のMOD、Thunderstoreから削除されたMODを確認できます。送信するリクエストの正確な件数を事前に伝え、ユーザーの承認を待ちます。Crew Checkを実行すると、Thunderstore MODとそのバージョンの簡単なリストを作成して協力プレイ仲間と共有し、仲間が貼り付けたリストと比較できます。ネットワーク通信は一切行いません。また、1つのMODについてTrust Cardを作成できます。誰が作成・アップロードしたか、掲載場所、日付、プラットフォーム独自の数値を表示します。どれもプラットフォームの記録に基づいており、ModWrench独自のスコアは付けません。（ツール13個）

競合チェックでは、2つの情報源を読み取ります。BethesdaのゲームについてはLOOTのマスターリストをその場で取得し、LOOTが対応していないゲームについてはパッケージに同梱された小さな競合リストを使います。同梱リストは空の状態で提供されます。3つのファイルすべてに [] が記載されているため、現時点では何も主張しません。将来のリリースで誰かのMODについて主張しうる情報源であるため、ここに記載しています。また、バージョンを固定しない限り、npx は最新バージョンを自動的に取得します。

さらに、メタツールが3つあります。1つはセッション中にプラットフォームを有効化し、1つはデッキを開きます。デッキには、接続済みのプラットフォームが表示されます（MCP Appsに対応するクライアントではページとして、それ以外ではテキストの接続リストとして表示されます）。もう1つは、ModWrenchのメンテナーに送るフィードバックをGitHub issueとして下書きします。内容を確認して自分で投稿してください（自動送信はしません）。

ツールは57個。そのうち56個は読み取り専用です。書き込みを行うのは1つだけです — 書き込みを行う唯一の機能を参照してください。

また、MCPクライアントから利用できるスラッシュコマンドを8つ登録します。/modwrench はデッキを開き、/mw-find は接続済みのすべてのプラットフォームを一度に検索し、/mw-crash はゲームがクラッシュした理由を確認します（最新のクラッシュログを自動で読み取ります）。/mw-conflicts はゲームのロード順を確認し、/mw-order はロード順を読み取り、/mw-patch はゲームのアップデートが安全かを確認し、/mw-doctor は環境が整っているかを確認し、/mw-critique はメンテナーに送るフィードバックの下書きを作成します。これらは上記のツールを呼び出すショートカットであり、ツールにない機能を追加するものではありません。

使い方

Node.js 20 以降が必要です。

Claude Code

claude mcp add --scope user modwrench -- npx -y @modwrench/cli

VS Code — コマンドパレット（Ctrl+Shift+P）を開き、MCP: Add Server を実行して、 Command (stdio) を選択し、npx -y @modwrench/cli を入力します。設定を書き込むよう VS Code に任せるのが 確実です。他のクライアントが使う mcpServers ではなく、VS Code のキーは servers だからです。 mcp.json を手動で編集する場合は、次のようにします。

{
  "servers": {
    "modwrench": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@modwrench/cli"]
    }
  }
}

MCP ツールを読み込めるのは Agent モードだけで、Ask モードでは読み込めません。チャットボックスのモードのドロップダウンを切り替えてください。

Claude Desktop、Cursor、Cline、Continue、Roo Code — クライアントの MCP 設定に追加します。 ここで使うキーは mcpServers です。VS Code で使うキーとは異なるので注意してください。

{
  "mcpServers": {
    "modwrench": {
      "command": "npx",
      "args": ["-y", "@modwrench/cli"]
    }
  }
}

クライアントを再起動してください。Thunderstore とローカルの Workbench ツールは、アカウントもキーも必要なく、すぐに使えます。

クライアントごとに利用できるツール。 上記のどの設定でも、AI クライアントは ModWrench を お使いのコンピューター上のプログラムとして起動します。これにより、Crash Whisperer、Doctors、Patch Day、 ロード順ツールがゲームのフォルダーを読み取れます。ウェブアプリで URL を指定して追加するコネクターのように、 インターネット経由でしか MCP サーバーに接続できないクライアントは、お使いのコンピューター上でプログラムを 起動できないため、これらのツールは利用できません。オプションの HTTP サーバー @modwrench/remote は そのようなケース向けで、公開されている Thunderstore ツールのみを提供します。認証情報を保持せず、 ファイルも読み取りません（その理由は TRUST.md を参照してください）。ウェブアプリから アクセスできる場所で実行する必要があります。特に指定がなければ 127.0.0.1 のポート 3000 で待ち受けますが、 MODWRENCH_REMOTE_HOST と MODWRENCH_REMOTE_PORT（または PORT）で変更できます。トンネルまたは プロキシの背後で実行する場合は、公開ホスト名を MODWRENCH_ALLOWED_HOSTS に（コンマ区切りで）指定してください。 指定しないと、すべてのリクエストが "Invalid Host" で拒否されます。ブラウザーからウェブページ経由で送られた リクエストは、そのページが同じコンピューター上にあり、サーバーが 127.0.0.1、localhost、または ::1 で 待ち受けている場合を除き、"Invalid Origin" で拒否されます。この場合以外は、ページのオリジンを MODWRENCH_ALLOWED_ORIGINS に正確に指定してください（コンマ区切り。例：https://app.example.com。 このリストを指定すると、デフォルトの許可設定は置き換えられます）。ブラウザー以外のプログラムが送る オリジンなしのリクエストには影響しません。ウェブアプリのコネクターは、アプリのサーバーから接続していても アプリのオリジンを送ることがあります。Claude のカスタムコネクターは https://claude.ai を送信すると報告されており、 https://claude.ai/ を送信する場合もあるため、これらを使う場合は MODWRENCH_ALLOWED_ORIGINS=https://claude.ai,https://claude.ai/ を設定してください。他の人が アクセスできるサーバーでは、100 セッションの上限を接続した全員で共有します （TRUST.md）。

Nexus と mod.io の接続

この 2 つには認証情報が必要です。

npx -y @modwrench/cli auth key nexus
npx -y @modwrench/cli auth key modio

各コマンドはキーの入力を求め、プラットフォームに対して検証した後、OS の認証情報マネージャーに保存します。 キーは Nexus API access と mod.io/me/access から取得してください。

キーを確認するには auth status nexus、削除するには auth logout nexus を実行します。

Nexus に接続する前に。 Nexus の API Acceptable Use Policy では、 個人利用の場合は個人用 API キーの使用が認められていますが、公開アプリケーションには独自のクライアント ID を登録するよう求めています。 ModWrench はまだ Nexus アプリケーションとして登録されていないため、Nexus に接続するということは、 個人用キーをサードパーティ製ツールで使うことになります。Nexus がこのような使い方をする個人用キーを制限する可能性があります。 影響を受けるのはお使いのキーであり、ModWrench ではありません。使いたくない場合は Nexus を利用しないでください。 他の機能は Nexus に依存していません。

認証情報

キーはオペレーティングシステムの認証情報マネージャー（Windows Credential Manager、macOS Keychain、または Linux の libsecret）に保存されます。サーバーはそこからのみキーを読み取り、ほかの場所からは読み取りません。認証情報ローダーには .env のパス、設定ファイルのパス、環境変数のパスはありません。認証情報マネージャーが空、またはアクセスできない場合、ModWrench はほかの場所を探すのではなく、その理由を知らせて停止します。

キーは、プラットフォームが有効になるとき（起動時、またはセッションの途中で後から有効にした場合はその時点）に読み取られ、プロセスが終了するまでメモリ内に保持されます。クロスプラットフォームの検索機能 mw_query_mod_metadata は、呼び出しのたびに認証情報マネージャーからキーを再読み込みします。

認証情報を書き込むのは auth key と auth login だけで、どちらも同じ認証情報マネージャーに保存します。auth logout は認証情報を削除します。ファイルに書き込むことはありません。

Nexus または mod.io で、いつでもキーを失効またはローテーションできます。こちら側で削除するものはありません。

接続先

ModWrench が通信する接続先は以下のとおりです。それ以外には接続しません。

ホスト	接続する場合
api.nexusmods.com	Nexus の MOD データ、およびオプトインした場合のクラッシュ原因の判定。Nexus に接続している場合のみ
users.nexusmods.com	auth login nexus で OAuth サインインを完了する間のみ
api.mod.io	mod.io の MOD データ。mod.io に接続している場合のみ
thunderstore.io	Thunderstore の公開読み取り API。Thunderstore の MOD に対する mw_query_mod_metadata と mw_trust_card、および同意した後の mw_pulse。MOD ごとに 1 件、その MOD の名前を含むリクエストを送信
raw.githubusercontent.com	競合チェックと要件チェックに使う、LOOT の公開マスターリスト
127.0.0.1	OAuth リダイレクトを受け取るローカルリスナー。auth login の実行中のみ
Nexus がファイルの content_preview_link で指定する CDN ホスト	nexus_file_preview のみ。Nexus はアーカイブの一覧を API の外部で提供するため、この呼び出しでは固定のホストではなく、Nexus が返す URL にアクセスします。認証情報は送信しません

ほかのドメイン（www.nexusmods.com や mod.io などの MOD ページへのリンク）は ModWrench の出力に含まれることがありますが、ModWrench がそれらを取得することはありません。リンクを開いた場合は、ブラウザーが取得します。Mods ページで「開く」を選ぶと、AI クライアントに MOD のページを開くよう依頼し、実際の動作はクライアントが決定します。

テレメトリはありません。分析機能もありません。アカウントもありません。こちらに送信されるものはありません。送信先となるこちら側が存在せず、このプロジェクトのために運用されているサーバーもないためです。

書き込みを行う唯一の機能

nexus_endorse_mod は、あなたとしてあなたのアカウントから、Nexus 上の MOD を推薦します。ModWrench で、いずれかのプラットフォームに変更を加える唯一のツールです。

誤って実行されることはありません。推薦を依頼すると、最初に返されるのはプレビューです。対象の MOD とバージョンに加え、推薦は公開され、ユーザー名が表示されることが示されます。確認しない限り、ネットワークへの呼び出しは一切行われません。 明示的に確認した 2 回目の呼び出しでのみ、推薦が送信されます。未確認の経路ではネットワークに一切アクセスしないことを検証するテストもあります。

そのほかはすべて読み取り専用です。

ローカルでは、Workbench ツールはファイルを読み取り専用で開きます。パッケージ内には、ファイルシステムに書き込む呼び出しはありません。

Mod 作者の方へ

プラットフォームのデータから生成されるすべての出力には、あなたの名前、データの取得元プラットフォーム、そしてあなたの Mod ページへのリンクが含まれます。これは、Nexus、mod.io、Thunderstore の検索、閲覧、検索結果の取得に関するすべてのツールに適用されます。

例外が一つだけあります。それはあなたにとって最も重要な箇所なので、見つけてもらうのを待たず、明確にお伝えします。クラッシュ診断ツールと競合チェックツールが参照するのは、プラットフォームの記録ではなくファイル名です。 mw_diagnose_crash はユーザー自身のディスクからクラッシュログを読み取り、見つかったプラグインのファイル名を報告します。mw_check_known_conflicts は LOOT のマスターリストからペアを報告します。ModWrench は、特定の .esp がどのプラットフォーム由来なのかを自動的には把握できません。それを調べるには、本来は何にも触れない診断でネットワーク検索を行う必要があります。

この隔たりは今、リクエストがあった場合に限り、部分的に埋められます。mw_diagnose_crash には、デフォルトではオフのオプトインフラグ attributeSuspects があり、名前が挙がった疑わしい Mod のうち最大 5 件について、Nexus の Mod ページを特定します。作者名、リンク、そして検索で一致した名前が返されるため、リンクをあなたのものとして提示する前に不一致を確認できます。これは名前による検索なので、間違う可能性があり、返されるすべての帰属情報にはその旨が示されます（matchedBy: "name-search"）。gameId と保存済みの Nexus 認証情報が必要です。これらがない場合は、帰属情報の特定をスキップしたと伝えて処理を続行します。mw_check_known_conflicts は引き続き帰属情報を特定しません。LOOT のマスターリストには作者のページ情報が含まれていないためです。

帰属情報の特定がオフ（デフォルト）、利用不可、または一致するものがない場合でも、クラッシュ診断はあなたの作品について否定的な内容、つまり「この Mod が原因である可能性が高い」と述べることがありますが、あなたへのリンクは付きません。各検出結果には、ログからの疑いであり、断定ではないことを示す免責事項が付いています。帰属情報の特定は隔たりを狭めますが、解消はしません。競合チェックツールには参照できる作者データがまったくなく、その隔たりは今も残っており、その旨も記載されています。

プラットフォームが作者の権利表記を提供している場合、ModWrench はそれをそのまま渡すため、確認できます。ModWrench は権利表記を強制しませんし、強制することもできません。これはメタデータをつなぐものであり、アクセスを制限するものではありません。ただし、クレジットを削除する手助けはしません。

エンドースツールがあるのも同じ理由です。このような橋渡しが、ページへのアクセスを奪うだけでなく、作品を作った人に何かを返すための唯一の方法です。

ステータス

開発初期段階です。まだ 1.0 以前であり、バグが発生する可能性があり、完璧ではありません。

このページの内容を鵜呑みにせず、何でも確認できるよう、ソースコードを公開しています。TRUST.md には、それぞれの主張と、自分で検証するためのコマンドが記載されています。事実でない内容を見つけた場合は、バグです。報告してください。

ライセンス

MIT