Emba MCP

🚀 EMBA-MCP

EMBA-MCP 是用於 EMBA 固件分析的模型上下文協議（MCP）服務器。它通過 MCP 以結構化工具的形式公開 EMBA 固件分析結果，允許大語言模型（如 Claude、ChatGPT 等）以編程方式查詢、推理和關聯固件安全發現。它能夠解析、規範化並對 EMBA 輸出進行推理。

✨ 主要特性

• 📦 解析 EMBA 結果（內核、服務、憑證、加密、軟件物料清單、二進制文件、PHP 等）
• 🔍 具備文件系統感知的分析（SUID、機密信息、弱加密、服務）
• 🚨 高風險關聯引擎（多信號發現）
• 🧭 攻擊路徑解釋引擎
• 🧠 MCP 原生工具（可接入 Claude / MCP 客戶端）
• 🔁 可處理現有的 EMBA 輸出（無需重新掃描）

📦 安裝指南

系統要求

• 系統：Linux（推薦：Ubuntu / Kali）
• Python：3.10 及以上版本
• 工具：EMBA 工具

安裝步驟

git clone https://github.com/0xbuz3R/EMBA-MCP.git
cd EMBA-MCP

# 設置虛擬環境（推薦）
python -m venv venv
# 在 Windows 上：
.\venv\Scripts\activate
# 在 macOS 上：
source venv/bin/activate

# 安裝依賴
pip install -e .

請確保 EMBA 已安裝在本地機器上：https://github.com/e-m-b-a/emba

Claude 桌面版 MCP 配置（必需）

要在 Claude 桌面版中使用 EMBA-MCP，必須在 Claude 的配置文件中註冊 MCP 服務器。此步驟是必需的，也是最常見的配置問題。

1. 定位 claude_config_desktop.json Claude 桌面版將 MCP 配置存儲在以下位置：
   • Linux：~/.config/claude/claude_config_desktop.json 如果文件不存在，請手動創建。
2. 添加 EMBA-MCP 服務器配置 在 mcpServers 部分添加以下 JSON。 ⚠️ 請勿盲目複製路徑，需將其替換為系統上有效的路徑。

{
  "mcpServers": {
    "emba": {
      "command": "<PATH_TO_PYTHON>",
      "args": ["-m", "emba_mcp.mcp_server"],
      "env": {
        "EMBA_HOME": "<PATH_TO_EMBA_DIRECTORY>"
      }
    }
  }
}

3. 如何正確填寫路徑
   • PATH_TO_PYTHON：這必須是安裝 EMBA-MCP 的 Python 解釋器。 示例：

which python
which python3

典型值： - /usr/bin/python3 - /home/user/.venv/bin/python - /home/user/.local/bin/python - PATH_TO_EMBA_DIRECTORY：這必須是 EMBA 的根目錄，即存在 emba 可執行文件的目錄。 示例：

ls <EMBA_HOME>/emba

示例值：/home/user/tools/emba 4. 重啟 Claude 桌面版 保存文件後： 1. 完全關閉 Claude 桌面版 2. 重新打開 Claude 現在將自動加載 EMBA MCP 服務器。 5. 驗證 MCP 是否加載 在 Claude 中嘗試： - 列出 EMBA 掃描 - 對固件運行 EMBA 掃描 如果配置正確，Claude 將無 MCP 錯誤地響應。

📽️ 演示

🤝 貢獻與反饋

我仍在努力整合其他一些數據項，將在下一版本中更新。

同時，請試用並提供改進建議！您可以在 https://github.com/0xbuz3R/EMBA-MCP/issues/1 留下您的建議。