Resourcehacker MCP

🚀 ResourceHacker MCP サーバー

Model Context Protocol (MCP) をベースにした ResourceHacker ツールサーバーです。Claude、codex などを通じて自然言語で Windows PE ファイルのリソースを操作できます。

✨ 主な機能

MCP プロトコルを通じて、ResourceHacker のコマンドライン機能にアクセスできます。

• リソースの抽出 - PE ファイル（exe、dll など）からアイコン、ビットマップ、ダイアログ、メニューなどのリソースを抽出します。
• リソースの一覧表示 - PE ファイルに含まれるすべてのリソースの一覧を、ファイルを抽出することなく確認できます。
• リソースの追加 - 実行ファイルに新しいリソースを追加します。
• リソースの削除 - PE ファイルからリソースを削除します。
• リソースの修正 - 既存のリソースを更新します。
• リソーススクリプトのコンパイル - .rc リソーススクリプトを .res バイナリファイルにコンパイルします。
• 言語の変更 - すべてのリソースの言語 ID を変更します。
• スクリプトの実行 - 複数のコマンドを含む ResourceHacker スクリプトを実行します。
• ヘルプの取得 - ResourceHacker のコマンドラインヘルプ情報を表示します。

📦 インストール

前提条件

• Windows オペレーティングシステム
• Node.js 18 以上のバージョン
• Claude code、codx などの mcp 対応アプリ
• ResourceHacker

手順 1：依存関係のインストール

git clone https://github.com/Valerian7/ResourceHacker-mcp.git
cd ResourceHacker-mcp
npm install

手順 2：MCP の設定

Claude に以下の設定を追加します。

{
  "mcpServers": {
    "resource-hacker": {
      "command": "node",
      "args": [
        "ResourceHacker-mcp_PATH\\ResourceHacker-mcp\\index.js"
      ],
      "env": {
        "RESOURCE_HACKER_PATH": "RESOURCE_HACKER_PATH\\ResourceHacker.exe"
      }
    }
  }
}

Codex に以下の設定を追加します。

[mcp_servers.resource_hacker_mcp]
type = "stdio"
command = "node"
args = ['ResourceHacker-mcp_PATH\\ResourceHacker-mcp\\index.js']

[mcp_servers.resource_hacker_mcp.env]
RESOURCE_HACKER_PATH = 'RESOURCE_HACKER_PATH\\ResourceHacker.exe'

• パスを実際のインストール場所に置き換えてください。
• ResourceHacker-mcp_PATH は ResourceHacker-mcp の完全パスを指します。
• RESOURCE_HACKER_PATH は ResourceHacker.exe の完全パスを指します。

💻 使用例

基本的な使用法

Claude、codex で以下を入力します。

ResourceHacker-mcp ツールを使って procexp64.exe を日本語化し、ウィンドウ階層に注意する

日本語化の効果の比較：

高度な使用法

各機能の詳細な使用例は以下の通りです。

1. list_resources - リソースの一覧表示

PE ファイルに含まれるすべてのリソースの一覧を、ファイルを抽出することなく確認できます。このコマンドにより、大量の一時ファイルが生成されるのを防げます。

パラメータ：

• input_file (必須)：入力 PE ファイルのパス

使用例：

myapp.exe 内のすべてのリソースを一覧表示する

2. extract_resource - リソースの抽出

PE ファイルまたはリソースファイルからリソースを抽出します。

パラメータ：

• input_file (必須)：入力 PE ファイルのパス
• output_path (必須)：出力ファイルまたはフォルダのパス
• resource_mask：リソースマスク形式 タイプ,名前,言語（デフォルト：,,）
• log_file：ログファイルのパスまたは CONSOLE（デフォルト：CONSOLE）

使用例：

notepad.exe からすべてのアイコンを icons フォルダに抽出する

3. add_resource - リソースの追加

PE ファイルに新しいリソースを追加します。

パラメータ：

• input_file (必須)：変更する PE ファイルのパス
• output_file (必須)：出力ファイルのパス
• resource_file (必須)：追加するリソースファイルのパス
• resource_mask：リソースマスク（デフォルト：,,）
• mode：追加モード - add（存在する場合は失敗）、addoverwrite（上書き）、addskip（スキップ）
• log_file：ログファイルのパス

使用例：

newicon.ico で myapp.exe のメインアイコンを置き換える

4. delete_resource - リソースの削除

PE ファイルからリソースを削除します。

パラメータ：

• input_file (必須)：PE ファイルのパス
• output_file (必須)：出力ファイルのパス
• resource_mask (必須)：削除するリソースを識別するマスク
• log_file：ログファイルのパス

5. modify_resource - リソースの修正

PE ファイル内の既存のリソースを修正します。

パラメータ：

• input_file (必須)：PE ファイルのパス
• output_file (必須)：出力ファイルのパス
• resource_file (必須)：新しいリソースファイルのパス
• resource_mask：リソースマスク
• log_file：ログファイルのパス

6. compile_rc - リソーススクリプトのコンパイル

リソーススクリプト（.rc）をバイナリ形式（.res）にコンパイルします。

パラメータ：

• input_rc (必須)：.rc ファイルのパス
• output_res (必須)：出力 .res ファイルのパス
• log_file：ログファイルのパス

使用例：

resources.rc を resources.res にコンパイルする

7. change_language - 言語の変更

PE ファイル内のすべてのリソースの言語を変更します。

パラメータ：

• input_file (必須)：PE ファイルのパス
• output_file (必須)：出力ファイルのパス
• language_id (必須)：言語 ID の数字
• log_file：ログファイルのパス

一般的な言語 ID：

• 1033：英語（米国）
• 2052：中国語（簡体字）
• 1028：中国語（繁体字）
• 1049：ロシア語
• 1031：ドイツ語
• 1036：フランス語
• 1041：日本語
• 1042：韓国語

使用例：

myapp.exe のすべてのリソースを簡体字中国語に変更する

8. run_script - スクリプトの実行

複数のコマンドを含む ResourceHacker スクリプトファイルを実行します。

パラメータ：

• script_file (必須)：スクリプトファイルのパス

9. get_help - ヘルプの取得

ResourceHacker のコマンドラインヘルプを取得します。

パラメータ：

• topic：ヘルプトピック - general、commandline または script

リソースマスク形式

リソースマスク形式：タイプ,名前,言語

• タイプ：リソースタイプ（例：ICON、BITMAP、DIALOG、MENU、STRINGTABLE、ICONGROUP）
• 名前：リソース名または ID
• 言語：言語 ID（0 は言語中立を表す）

例：

• ICON,, - すべてのアイコン、任意の名前、任意の言語
• BITMAP,128,0 - ID が 128 のビットマップ、言語中立
• ICONGROUP,MAINICON, - MAINICON という名前のアイコングループ、任意の言語
• ,,1033 - すべての英語（米国）リソース

🔧 技術詳細

よくある質問

MCP サーバーが Claude に表示されない場合

1. 設定ファイルのパスが正しいことを確認し、ダブルバックスラッシュを使用してください。
2. Node.js がインストールされていることを確認します：node --version を実行します。
3. npm install が正常に完了していることを確認します。
4. Claude Desktop を完全に再起動します（ウィンドウを閉じるだけでなく）。
5. Claude Desktop のログにエラーがないことを確認します。

パスの問題

設定ファイル内のパスが絶対パスで、ダブルバックスラッシュを使用していることを確認してください。

• ✅ 正しい："D:\\Tools\\resource_hacker\\mcp_server\\index.js"
• ❌ 間違い："D:\Tools\resource_hacker\mcp_server\index.js"
• ❌ 間違い："./index.js" または "index.js"

ResourceHacker.exe が見つからない場合

設定で RESOURCE_HACKER_PATH 環境変数が正しく設定され、ResourceHacker.exe の完全パスを指していることを確認してください。

権限エラー

システムファイルを変更する場合は、適切な権限が必要です。特に、システムディレクトリ内のファイルを変更するときに注意してください。

制限事項

• Windows オペレーティングシステムが必要です。
• ResourceHacker.exe にアクセスできる必要があります。
• "パックされた" または "圧縮された" 実行ファイルは変更できません。
• 一部の操作には、対象ファイルへの書き込み権限が必要です。

参考リンク

• ResourceHacker 公式サイト
• Model Context Protocol
• Windows リソースタイプドキュメント

更新履歴

v1.1.0

• 新しい list_resources ツールを追加。リソースを抽出せずに一覧を確認でき、ファイルの混乱を減らします。
• コード構造を最適化し、一時ファイルのクリーンアップ機構を追加します。
• parseRcFile の解析ロジックを修正します。

v1.0.0

• 初期バージョン
• 8 つの MCP ツールを実装
• 設定可能な ResourceHacker.exe のパスをサポート
• 完全なエラー処理とログ記録を実装