Add it to Claude Code
claude mcp add -e "EMBA_HOME=${EMBA_HOME}" emba-mcp -- "<PATH_TO_PYTHON>" -m emba_mcp.mcp_serverEMBA_HOMEMake your agent remember this setup
emba-mcp's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Parses and normalizes EMBA firmware analysis results
- Provides filesystem-aware analysis including SUID and secret detection
- Includes a high-risk correlation engine for multi-signal findings
- Features an attack-path explanation engine
- Works with existing EMBA output without requiring re-scans
Tools 2
list_emba_scansLists available EMBA firmware analysis scans.run_emba_scanRuns an EMBA scan on a specified firmware file.Environment Variables
EMBA_HOMErequiredThe root directory of the EMBA installation.Try it
Original README from 0xbuz3R/EMBA-MCP
🧠 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": "",
"args": ["-m", "emba_mcp.mcp_server"],
"env": {
"EMBA_HOME": ""
}
}
}
}
📌 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
📍 4. Restart Claude Desktop
After saving the file:
- Fully close Claude Desktop
- Reopen it
Claude will now auto-load the EMBA MCP server
✅ 5. Verify MCP Is Loaded
Inside Claude, try:
List EMBA scans or Run EMBA scan on firmware
If configured correctly, Claude will respond without MCP errors.
📽️ Demo
🤝 Contributing & Feedback
I am still working on a few other data items to integrate; I'll update in the next release.
Meanwhile, please give it a try and provide feedback on how to improve! You can leave your suggestions in our https://github.com/0xbuz3R/EMBA-MCP/issues/1