Emba MCP

🚀 EMBA - MCP

EMBAファームウェア分析用のモデルコンテキストプロトコル（MCP）サーバーです。EMBA - MCPは、MCPを介してEMBAファームウェア分析結果を構造化ツールとして公開し、LLM（Claude、ChatGPTなど）がプログラム的にファームウェアのセキュリティ調査結果を照会、推論、関連付けできるようにします。 EMBAの出力を解析、正規化、推論します。

✨ 主な機能

• 📦 EMBAの結果（カーネル、サービス、資格情報、暗号、SBOM、バイナリ、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 Desktop MCPの設定（必須）

Claude Desktop内でEMBA - MCPを使用するには、Claudeの設定ファイルにMCPサーバーを登録する必要があります。 この手順は必須であり、最も一般的な設定問題の原因です。

📍 1. claude_config_desktop.jsonの場所を特定する

Claude Desktopは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 Desktopを再起動する

ファイルを保存した後：

1. Claude Desktopを完全に閉じます。
2. 再度開きます。

Claudeは、これで自動的にEMBA MCPサーバーを読み込みます。

✅ 5. MCPが読み込まれていることを確認する

Claude内で以下を試してみてください。

• EMBAスキャンを一覧表示する
• ファームウェアでEMBAスキャンを実行する

正しく設定されていれば、ClaudeはMCPエラーなしで応答します。

📽️ デモ

🤝 貢献とフィードバック

他のいくつかのデータ項目を統合する作業をまだ行っています。次のリリースで更新します。

その間、ぜひ試してみて、改善案をフィードバックしてください！ ご提案はこちらのhttps://github.com/0xbuz3R/EMBA-MCP/issues/1 に残していただけます。