Deobfuscate MCP Server

🚀 反混淆MCP服務器

這是一個經過大語言模型優化的模型上下文協議（MCP）服務器，旨在幫助大語言模型對壓縮和打包後的JavaScript代碼進行逆向工程、導航和理解。

🚀 快速開始

本服務器將壓縮代碼視為一個可搜索的數據庫，解決了標準“美化器”僅格式化代碼，導致大語言模型難以處理超出上下文窗口的大量線性文本文件的問題。它允許大語言模型執行以下操作：

1. 反混淆和解包：使用webcrack將Webpack/Browserify包拆分為單個模塊。
2. 查看架構：在讀取代碼之前，返回文件結構（導出、函數）的JSON摘要。
3. 隨機導航：按需讀取特定模塊（get_module），而不是整個文件。
4. 語義搜索：在數千個解包模塊中查找特定字符串或模式的存在位置。

✨ 主要特性

• deobfuscate：入口點。解包並將包緩存到內存中。
  • returnCode（默認false）：默認返回摘要以節省上下文。設置為true可查看完整代碼。
  • skipVendor：過濾掉node_modules和Webpack樣板代碼，專注於應用代碼。
  • mangle：縮短變量名以節省令牌。
  • jsx：恢復React JSX語法。
• analyze_structure：返回高級抽象語法樹（AST）摘要（函數、類、導出）以節省令牌。
• list_modules：列出解包包中找到的所有模塊。
• list_functions：掃描緩存模塊，列出具有簽名和參數的已定義函數/類。
• get_call_graph：為特定函數生成調用圖，識別它調用的內容和調用它的內容。
• get_module：獲取單個模塊的格式化源代碼。
• get_symbol_source：僅提取特定函數、類或變量以節省令牌。
• search_modules：在所有模塊中進行正則表達式/字符串搜索。
• format_code：對JS/HTML/CSS進行標準的Prettier格式化。
• get_help：返回任何工具的詳細文檔。

📦 安裝指南

從npm安裝（推薦）

npm install -g deobfuscate-mcp-server

從源代碼構建

git clone https://github.com/ricardodeazambuja/deobfuscate-mcp-server.git
cd deobfuscate-mcp-server
npm install
npm run build

打包並安裝（可選）

要創建可分發的tarball並全局安裝：

npm pack
npm install -g ./deobfuscate-mcp-server-1.0.0.tgz

💻 使用示例

客戶端配置

要將此服務器與你喜歡的大語言模型客戶端一起使用，請添加以下配置。

Claude Code

在終端中運行以下命令：

claude mcp add deobfuscate-mcp-server -- npx -y deobfuscate-mcp-server

或者，編輯~/Library/Application Support/Claude/claude_desktop_config.json：

{
  "mcpServers": {
    "deobfuscate-mcp-server": {
      "command": "npx",
      "args": ["-y", "deobfuscate-mcp-server"]
    }
  }
}

Gemini CLI

在終端中運行以下命令：

gemini mcp add deobfuscate-mcp-server npx -y deobfuscate-mcp-server

或者，編輯~/.gemini/settings.json：

{
  "mcpServers": {
    "deobfuscate-mcp-server": {
      "command": "npx",
      "args": ["-y", "deobfuscate-mcp-server"]
    }
  }
}

Antigravity

在終端中運行以下命令：

antigravity --add-mcp '{"deobfuscate-mcp-server": {"command": "npx", "args": ["-y", "deobfuscate-mcp-server"]}}'

或者，編輯~/.antigravity/settings.json：

{
  "mcpServers": {
    "deobfuscate-mcp-server": {
      "command": "npx",
      "args": ["-y", "deobfuscate-mcp-server"]
    }
  }
}

開發/本地使用

如果你從源代碼運行服務器，請將命令替換為：

"command": "node",
"args": ["ABSOLUTE_PATH_TO_DIST/index.js"]

(將ABSOLUTE_PATH_TO_DIST替換為你機器上dist文件夾的實際絕對路徑)

啟動服務器

node dist/index.js

大語言模型的示例工作流程

1. 用戶：“分析這個壓縮文件：bundle.min.js...”
2. 大語言模型：調用deobfuscate(code="...", skipVendor=true)。
   • 服務器：“反混淆完成。解包了15個模塊。跳過了45個供應商模塊...”
3. 大語言模型：“好的，我看到入口點需要模塊42。那是什麼？”
4. 大語言模型：調用get_module(id="42")。
   • 服務器：返回模塊42的代碼。
5. 大語言模型：“'login'函數在哪裡定義？”
6. 大語言模型：調用search_modules(query="function login")。
   • 服務器：“在模塊88中找到。”
7. 大語言模型：“我只想查看login函數的邏輯。”
8. 大語言模型：調用get_symbol_source(symbolName="login", moduleId="88")。
   • 服務器：僅返回'login'函數的源代碼。

📚 詳細文檔

開發

• 構建：npm run build
• 測試：npm test

限制

• 文件大小：服務器接受最大為50MB的輸入文件（包）。
• 內存：解包的模塊會緩存在RAM中。非常大的包（解包後數百MB）可能會耗盡服務器的可用內存，具體取決於你的環境。