MMCPMarkets
CS

circuit-synth/mcp-kicad-sch-api

Developer tools
20 stars 0 forks Качество 99 Тренд 99
Repository Install

Model Context Protocol server for KiCAD schematic manipulation - AI agent integration for electronic circuit design

Обзор

Model Context Protocol (MCP) server providing KiCAD schematic manipulation tools for AI agents. This MCP server exposes the kicad-sch-api library as tools that AI agents can use to create, modify, and analyze KiCAD schematic files. - 🔧 : Generate new KiCAD schematic files - ⚡ : Place resistors, capacitors, ICs, and more - 🔍 : Find parts in KiCAD symbol libraries - 🔗 : Create wires and nets - 📐 : Support for hierarchical sheets and labels - 🎯 : Maintains exact KiCAD file format compatibility If the automatic method doesn't work, manually edit your Claude Code config file: after configuration to load the MCP server. The server supports standard MCP stdio transport and should work with any MCP-compatible client. - "Create a voltage divider circuit with two 10kΩ resistors" - "Add an Arduino Nano to the schematic at position (100, 100)" - "Search for operational amplifiers in the KiCAD libraries" - "Create a hierarchical sheet for the power supply section" - Python 3.

README

MCP KiCAD Schematic API

Model Context Protocol (MCP) server providing KiCAD schematic manipulation tools for AI agents.

Overview

This MCP server exposes the kicad-sch-api library as tools that AI agents can use to create, modify, and analyze KiCAD schematic files.

Features

  • 🔧 Create Schematics: Generate new KiCAD schematic files
  • ⚡ Add Components: Place resistors, capacitors, ICs, and more
  • 🔍 Search Components: Find parts in KiCAD symbol libraries
  • 🔗 Add Connections: Create wires and nets
  • 📐 Hierarchical Design: Support for hierarchical sheets and labels
  • 🎯 Format Preservation: Maintains exact KiCAD file format compatibility

Quick Start

Installation

pip install mcp-kicad-sch-api

Configuration

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "kicad-sch-api": {
      "command": "python",
      "args": ["-m", "mcp_kicad_sch_api"],
      "env": {}
    }
  }
}

Claude Code

Option 1: Automatic (Recommended)

# Add MCP server automatically
claude mcp add mcp-kicad-sch-api /path/to/your/venv/bin/mcp-kicad-sch-api

# Example with specific venv path:
claude mcp add mcp-kicad-sch-api /Users/username/myproject/venv/bin/mcp-kicad-sch-api

Option 2: Manual Configuration If the automatic method doesn’t work, manually edit your Claude Code config file:

# Find your config file location
code ~/.claude.json

Add the MCP server configuration:

{
  "mcpServers": {
    "mcp-kicad-sch-api": {
      "command": "/path/to/your/venv/bin/mcp-kicad-sch-api"
    }
  }
}

Finding Your Installation Path:

# After installing in your venv, find the executable path:
which mcp-kicad-sch-api
# Example output: /Users/username/myproject/venv/bin/mcp-kicad-sch-api

Restart Claude Code after configuration to load the MCP server.

Other MCP Clients

The server supports standard MCP stdio transport and should work with any MCP-compatible client.

Usage Examples

Ask your AI agent:

  • “Create a voltage divider circuit with two 10kΩ resistors”
  • “Add an Arduino Nano to the schematic at position (100, 100)”
  • “Search for operational amplifiers in the KiCAD libraries”
  • “Create a hierarchical sheet for the power supply section”

Tools Available

Tool Description
create_schematic Create a new KiCAD schematic file
add_component Add components (resistors, capacitors, ICs, etc.)
search_components Search KiCAD symbol libraries
add_wire Create wire connections
add_hierarchical_sheet Add hierarchical design sheets
add_sheet_pin Add pins to hierarchical sheets
add_hierarchical_label Add hierarchical labels
list_components List all components in schematic
get_schematic_info Get schematic information

Requirements

  • Python 3.10+
  • KiCAD (for symbol libraries)
  • kicad-sch-api library

Development

git clone https://github.com/circuit-synth/mcp-kicad-sch-api.git
cd mcp-kicad-sch-api
uv sync --dev
uv run python -m mcp_kicad_sch_api

License

MIT License - see LICENSE file.

🤖 AI-Powered Circuit Design Made Easy

View this README on GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide

Конфигурация

{ "mcpServers": { "kicad-sch-api": { "command": "python", "args": ["-m", "mcp_kicad_sch_api"], "env": {} } } }