# eda-agent

MCP server for controlling live Altium Designer, KiCad, and EasyEDA sessions via AI agents. It enables agents to read open designs, answer technical queries, and modify projects in real time.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 392 repo stars
- Author: salitronic
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/salitronic/eda-agent
- Updated: 2026-11-16
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/eda-agent

## What it does

This server bridges an AI agent with your PCB design software using a DelphiScript-based IPC connection. It exposes over 600 tools for schematic, PCB, and library operations, allowing the agent to handle tasks ranging from component creation to generating manufacturing outputs like Gerbers and BOMs.

It runs as a Python process that communicates with the active editor session. Since it operates on your live project, you see changes happen instantly within the editor. The architecture supports batch processing, allowing the agent to execute multiple edits in a single request for improved performance.

A local dashboard is available at `http://127.0.0.1:8766` for design reviews and data inspection. An in-editor status window also provides control over agent permissions and real-time command logging.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `EDA_AGENT_BACKEND`, `EDA_AGENT_TOOLSET` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env EDA_AGENT_BACKEND=<EDA_AGENT_BACKEND> --env EDA_AGENT_TOOLSET=<EDA_AGENT_TOOLSET> --transport stdio eda-agent -- uvx eda-agent
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from eda-agent <command>

### Codex

**Platform CLI**
```bash
codex mcp add eda-agent --env EDA_AGENT_BACKEND=<EDA_AGENT_BACKEND> --env EDA_AGENT_TOOLSET=<EDA_AGENT_TOOLSET> -- uvx eda-agent
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from eda-agent <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "eda-agent": {
            "command": "uvx",
            "args": [
                "eda-agent"
            ],
            "env": {
                "EDA_AGENT_BACKEND": "<EDA_AGENT_BACKEND>",
                "EDA_AGENT_TOOLSET": "<EDA_AGENT_TOOLSET>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from eda-agent <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "eda-agent": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "eda-agent"
            ],
            "env": {
                "EDA_AGENT_BACKEND": "<EDA_AGENT_BACKEND>",
                "EDA_AGENT_TOOLSET": "<EDA_AGENT_TOOLSET>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from eda-agent <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e EDA_AGENT_BACKEND=<EDA_AGENT_BACKEND> -e EDA_AGENT_TOOLSET=<EDA_AGENT_TOOLSET> eda-agent uvx eda-agent
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from eda-agent <command>

## When to use it
- automate symbol and footprint creation
- verify netlist and BOM integrity
- route differential pairs based on specifications
- generate manufacturing and assembly files
- apply design changes from text descriptions

## Example prompts
- Analyze the current project and list missing datasheet information.
- Place 61 LEDs in a circular pattern on the PCB.
- Generate the BOM, drill files, and STEP models for this project.

## Similar
- [eda-pcb](https://affpapa.org/en/nevibecode/skills/eda-pcb.md) — skill · 487 installs
- [eda-drc](https://affpapa.org/en/nevibecode/skills/eda-drc.md) — skill · 162 installs
- [altium-designer-mcp](https://affpapa.org/en/nevibecode/mcp/altium-designer-mcp.md) — MCP server · ★ 96 repo stars
- [KiCad MCP Pro](https://affpapa.org/en/nevibecode/mcp/kicad-mcp-pro.md) — MCP server · ★ 230 repo stars
- [KiCad Copilot](https://affpapa.org/en/nevibecode/mcp/kicad-copilot.md) — MCP server · ★ 24 repo stars
- [KiCad Tools](https://affpapa.org/en/nevibecode/mcp/kicad-tools.md) — MCP server · ★ 16 repo stars

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
