이 가이드는 KiCad용 모델 컨텍스트 프로토콜(MCP) 서버를 설정하는 데 도움을 줄 것입니다. 이 가이드의 예시들은 종종 Claude Desktop을 언급하지만, 이 서버는 모든 MCP 호환 클라이언트와 호환됩니다. Claude Desktop, 자체 커스텀 MCP 클라이언트, 또는 모델 컨텍스트 프로토콜을 구현한 다른 애플리케이션과 함께 사용할 수 있습니다.

목차

• 선수 조건
• 설치 단계
• MCP 구성 요소 이해하기
• 특집 하이라이트
• 자연어 상호작용
• 문서
• 구성
• 개발 가이드
• 문제 해결
• 기여
• 미래 개발 아이디어
• 면허

선수 조건

• macOS, 윈도우, 리눅스
• Python 3.10 이상
• KiCad 9.0 이상
• uv 0.8.0 이상
• 클로드 데스크톱(또는 다른 MCP 클라이언트)

설치 단계

1. 파이썬 환경을 설정하세요

먼저, 의존성을 설치하고 환경을 설정해 봅시다:

2. 환경 구성

서버가 KiCad 프로젝트를 어디에 위치하는지 커스터마이징할 수 있는 .env 파일을 생성하세요:

.env 파일에서 사용자 지정 프로젝트 디렉터리를 추가하세요:

3. 서버를 운영하세요

환경이 설정되면 서버를 실행할 수 있습니다:

4. MCP 클라이언트 구성

KiCad MCP Server

This guide will help you set up a Model Context Protocol (MCP) server for KiCad. While the examples in this guide often reference Claude Desktop, the server is compatible with any MCP-compliant client. You can use it with Claude Desktop, your own custom MCP clients, or any other application that implements the Model Context Protocol.

Table of Contents

• Prerequisites
• Installation Steps
• Understanding MCP Components
• Feature Highlights
• Natural Language Interaction
• Documentation
• Configuration
• Development Guide
• Troubleshooting
• Contributing
• Future Development Ideas
• License

Prerequisites

• macOS, Windows, or Linux
• Python 3.10 or higher
• KiCad 9.0 or higher
• uv 0.8.0 or higher
• Claude Desktop (or another MCP client)

Installation Steps

1. Set Up Your Python Environment

First, let’s install dependencies and set up our environment:

# Clone the repository
git clone https://github.com/lamaalrajih/kicad-mcp.git
cd kicad-mcp

# Install dependencies – `uv` will create a `.venv/` folder automatically
# (Install `uv` first: `brew install uv` on macOS or `pipx install uv`)
make install

# Optional: activate the environment for manual commands
source .venv/bin/activate

2. Configure Your Environment

Create a .env file to customize where the server looks for your KiCad projects:

# Copy the example environment file
cp .env.example .env

# Edit the .env file
vim .env

In the .env file, add your custom project directories:

# Add paths to your KiCad projects (comma-separated)
KICAD_SEARCH_PATHS=~/pcb,~/Electronics,~/Projects/KiCad

3. Run the Server

Once the environment is set up, you can run the server:

python main.py

4. Configure an MCP Client

Now, let’s configure Claude Desktop to use our MCP server:

1. Create or edit the Claude Desktop configuration file:

# Create the directory if it doesn't exist
mkdir -p ~/Library/Application\ Support/Claude

# Edit the configuration file
vim ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. Add the KiCad MCP server to the configuration:

{
    "mcpServers": {
        "kicad": {
            "command": "/ABSOLUTE/PATH/TO/YOUR/PROJECT/kicad-mcp/.venv/bin/python",
            "args": [
                "/ABSOLUTE/PATH/TO/YOUR/PROJECT/kicad-mcp/main.py"
            ]
        }
    }
}

Replace /ABSOLUTE/PATH/TO/YOUR/PROJECT/kicad-mcp with the actual path to your project directory.

5. Restart Your MCP Client

Close and reopen your MCP client to load the new configuration.

Understanding MCP Components

The Model Context Protocol (MCP) defines three primary ways to provide capabilities: