# mxiris-reverse-engineering/ida-mcp-server architecture

> Architecture diagram of the GitHub repository mxiris-reverse-engineering/ida-mcp-server, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-04-18). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/mxiris-reverse-engineering/ida-mcp-server
- Repository: https://github.com/mxiris-reverse-engineering/ida-mcp-server

## Overview

##### Project type and purpose
- This is a hybrid “plugin + server” tool:
- A Python‑based Model Context Protocol (MCP) server (`mcp_server_ida`) that exposes an API for LLM‑driven inspection of IDA databases.
- A companion IDA Pro plugin (`ida_mcp_server_plugin`) that runs inside the IDA GUI and communicates with the server.
- Use case: automate and script IDA disassembly analysis via LLMs (e.g., Claude, OpenAI).

##### File structure
- Top‑level directories:
- `plugin/` → holds the IDA plugin entrypoint (`ida_mcp_server_plugin.py`) and module (`ida_mcp_server_plugin/ida_mcp_core.py`).
- `src/mcp_server_ida/` → the server’s source code (`__main__.py` for CLI startup, `server.py` for core logic).
- `test/` → local tests and debug scripts.
- `Screenshots/` → UI examples (could be omitted or shown as “docs”).
- Config/build files:
- `pyproject.toml` → Python packaging & dependencies.
- `uv.lock` → lockfile for the `uv` runner.
- Notice the clear “frontend” (IDA plugin) vs. “backend” (MCP server) separation.

##### Extract key insights from the README
- The server runs via `uvx mcp-server-ida` or `python -m mcp_server_ida`.
- The plugin is copied into IDA’s plugin directory and uses Python‑IDA API to forward requests to the server.
- External integration points: LLM providers (configured via MCP inspector), Claude Desktop, logs, debugging tools.

## Diagram (Mermaid)

```mermaid
flowchart TB
    %% Client Environment
    subgraph "Client Environment"
        direction TB
        User["User"]:::external
        IDAGUI["IDA Pro GUI"]:::client
        PluginEntrypoint["IDA MCP Plugin\n(plugin/ida_mcp_server_plugin.py)"]:::client
        PluginCore["Plugin Core Module\n(ida_mcp_core.py)"]:::client
    end

    %% Server Environment
    subgraph "Server Environment"
        direction TB
        ServerEntry["MCP Server CLI\n(__main__.py)"]:::server
        ServerCore["MCP Server Core\n(server.py)"]:::server
        Config["pyproject.toml"]:::storage
        Lockfile["uv.lock"]:::storage
        Tests["Local Tests & Debug\n(test/IDA Debug.py)"]:::storage
        README["Project Documentation\n(README.md)"]:::storage
        Screens["UI Screenshots\n(Screenshots/)"]:::storage
    end

    %% External Environment
    subgraph "Cloud/External"
        direction TB
        LLM["LLM Provider(s)"]:::external
    end

    %% Connections
    User -->|"opens"| IDAGUI
    IDAGUI -->|"loads plugin"| PluginEntrypoint
    PluginEntrypoint -->|"initializes"| PluginCore
    PluginCore -->|"MCP request"| ServerEntry
    ServerEntry -->|"calls"| ServerCore
    ServerCore -->|"reads/writes"| Config
    ServerCore -->|"reads/writes"| Lockfile
    ServerCore -->|"runs tests via"| Tests
    ServerCore -->|"references docs"| README
    ServerCore -->|"references UI examples"| Screens
    ServerCore -->|"LLM query"| LLM
    LLM -->|"LLM response"| ServerCore
    ServerCore -->|"MCP response"| PluginCore
    PluginCore -->|"display results"| IDAGUI

    %% Click Events
    click PluginEntrypoint "https://github.com/mxiris-reverse-engineering/ida-mcp-server/blob/main/plugin/ida_mcp_server_plugin.py"
    click PluginCore "https://github.com/mxiris-reverse-engineering/ida-mcp-server/blob/main/plugin/ida_mcp_server_plugin/ida_mcp_core.py"
    click ServerEntry "https://github.com/mxiris-reverse-engineering/ida-mcp-server/blob/main/src/mcp_server_ida/__main__.py"
    click ServerCore "https://github.com/mxiris-reverse-engineering/ida-mcp-server/blob/main/src/mcp_server_ida/server.py"
    click Config "https://github.com/mxiris-reverse-engineering/ida-mcp-server/blob/main/pyproject.toml"
    click Lockfile "https://github.com/mxiris-reverse-engineering/ida-mcp-server/blob/main/uv.lock"
    click Tests "https://github.com/mxiris-reverse-engineering/ida-mcp-server/blob/main/test/IDA Debug.py"
    click README "https://github.com/mxiris-reverse-engineering/ida-mcp-server/blob/main/README.md"
    click Screens "https://github.com/mxiris-reverse-engineering/ida-mcp-server/tree/main/Screenshots/"

    %% Styles
    classDef client fill:#e0f2ff,stroke:#0288d1,stroke-width:2px
    classDef server fill:#e8f5e9,stroke:#2e7d32,stroke-width:2px
    classDef external fill:#fff3e0,stroke:#ef6c00,stroke-width:2px
    classDef storage fill:#eceff1,stroke:#607d8b,stroke-width:2px
```
