How do I use EMBA-MCP?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@EMBA-MCP summarize the security findings for my latest firmware scan" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

EMBA-MCP by 0xbuz3R

🧠 EMBA-MCP

Model Context Protocol (MCP) server for EMBA firmware analysis. EMBA-MCP exposes EMBA firmware analysis results as structured tools via MCP, allowing LLMs (Claude, ChatGPT, etc.) to query, reason, and correlate firmware security findings programmatically. It parses, normalizes, and reasons over EMBA output.

✨ Features

📦 Parse EMBA results (kernel, services, credentials, crypto, SBOM, binaries, PHP, etc.) 🔍 Filesystem-aware analysis (SUID, secrets, weak crypto, services) 🚨 High-risk correlation engine (multi-signal findings) 🧭 Attack-path explanation engine 🧠 MCP-native tools (plug into Claude / MCP clients) 🔁 Works with existing EMBA output (no re-scan required)

📋 Requirements System Linux (recommended: Ubuntu / Kali) Python 3.10+ EMBA Tool

🛠️ Installation

git clone https://github.com/0xbuz3R/EMBA-MCP.git cd EMBA-MCP Set Up a Virtual Environment (Recommended) Bash python -m venv venv # On Windows: .\venv\Scripts\activate # On macOS: source venv/bin/activate 3. Install Dependencies Bash pip install -e .

Make sure EMBA is installed in your local machine: https://github.com/e-m-b-a/emba

🧩 Claude Desktop MCP Configuration (Required)

To use EMBA-MCP inside Claude Desktop, you must register the MCP server in Claude’s config file. This step is mandatory and is the most common setup issue.

📍 1. Locate claude_config_desktop.json

Claude Desktop stores the MCP configuration in the following location:

Linux

~/.config/claude/claude_config_desktop.json

If the file does not exist, create it manually.

📍 2. Add EMBA-MCP Server Configuration

Add the following JSON under the mcpServers section.

⚠️ Do NOT copy paths blindly — replace them with paths valid on your system.

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

📌 3. How to Fill the Paths Correctly

🔹 PATH_TO_PYTHON

This must be the Python interpreter where EMBA-MCP is installed. Examples:

which python which python3

Typical values:

/usr/bin/python3 /home/user/.venv/bin/python /home/user/.local/bin/python

🔹 PATH_TO_EMBA_DIRECTORY

This must be the root directory of EMBA, where the emba executable exists.

Example:

ls <EMBA_HOME>/emba

Example value:

/home/user/tools/emba