Resourcehacker MCP

🚀 ResourceHacker MCP 服務器

基於 Model Context Protocol (MCP) 的 ResourceHacker 工具服務器，可藉助 Claude、codex 等，運用自然語言對 Windows PE 文件資源進行操作。

🚀 快速開始

在Claude、codex中輸入

調用ResourceHacker-mcp工具漢化procexp64.exe，注意窗口層級

漢化效果對比：

✨ 主要特性

通過 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 的完整路徑。

💻 使用示例

基礎用法

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 路徑。
• 完整的錯誤處理和日誌記錄。