Meta Agent Tools
PT

Back to the catalog

io.github.daedalus/mcp-kicad

MCP server exposing KiCad PCB Editor functionality via IPC API

Open source Open in the app JSON README (API)

About

MCP server exposing KiCad PCB Editor functionality via IPC API

Details

Kind
MCP servers
Topic
No topic detected
Publisher
daedalus
Origin
official
Category
ferramentas
Transport
local
Version
0.1.1
Last push
2026-04-21T19:26:52Z
Repository state
ativo
Language
Python
License
MIT
Added
2026-08-29 03:02:39
Updated
2026-08-29 03:02:39
Origin id
io.github.daedalus/mcp-kicad

README

mcp-kicad — MCP server exposing KiCad PCB Editor functionality via IPC API.

[![PyPI](https://img.shields.io/pypi/v/mcp-kicad.svg)](https://pypi.org/project/mcp-kicad/)
[![Python](https://img.shields.io/pypi/pyversions/mcp-kicad.svg)](https://pypi.org/project/mcp-kicad/)
[![Ruff](https://img.shields.io/endpoint?url=https://raw.githubusercontent.com/astral-sh/ruff/main/assets/badge/v2.json)](https://github.com/astral-sh/ruff)

## Install

```bash
pip install mcp-kicad
```

## Requirements

- KiCad 9.0 or higher with the IPC API server enabled
- Go to **Preferences > Plugins** in KiCad and enable the API server

## Usage

The MCP server communicates with a running KiCad instance via the IPC API. Start KiCad first, then run the server:

```bash
mcp-kicad
```

Or configure it in your MCP client:

```json
{
  "mcpServers": {
    "mcp-kicad": {
      "command": "mcp-kicad",
      "env": {}
    }
  }
}
```

## Tools

The server exposes the following tools:

- **Connection**: `connect_kicad`, `check_connection`
- **Board**: `get_board_info`, `get_layers`, `get_board_design_settings`
- **Footprints**: `list_footprints`, `get_footprint`, `search_footprints`
- **Nets**: `list_nets`, `get_net`, `list_netclasses`
- **Zones**: `list_zones`
- **Tracks/Vias**: `list_tracks`, `list_vias`
- **Pads**: `list_pads`
- **Text**: `list_texts`, `get_text_extents`
- **Project**: `get_project`, `get_version`

## Example

```python
from mcp_kicad import mcp_server

# Connect to running KiCad
result = mcp_server.connect_kicad()

# Get board info
board_info = mcp_server.get_board_info()
print(board_info)

# List all footprints
footprints = mcp_server.list_footprints()
for fp in footprints:
    print(f"{fp['reference']}: {fp['value']}")
```

## Development

```bash
git clone https://github.com/daedalus/mcp-kicad.git
cd mcp-kicad
pip install -e ".[test]"

# run tests
pytest

# format
ruff format src/ tests/

# lint
ruff check src/ tests/

# type check
mypy src/
```

mcp-name: io.github.daedalus/mcp-kicad

More