このガイドは、KiCad用のモデルコンテキストプロトコル(MCP)サーバーの設定に役立ちます。このガイドの例はしばしばClaude Desktopを参照していますが、このサーバーはすべてのMCP準配クライアントと互換性があります。Claude Desktop、自社のカスタムMCPクライアント、またはモデルコンテキストプロトコルを実装する他のアプリケーションでも使用できます。

目次

• 前提条件
• 設置手順
• MCPコンポーネントの理解
• 特集ハイライト
• 自然言語相互作用
• 文書化
• 構成
• 開発ガイド
• トラブルシューティング
• 貢献
• 将来の開発アイデア
• ライセンス

前提条件

• macOS、Windows、またはLinux
• Python 3.10以降
• KiCad 9.0以上
• UV 0.8.0以上
• Claude Desktop(または他のMCPクライアント)

設置手順

1.Python環境をセットアップしましょう

まずは依存関係をインストールし、環境を構築しましょう。

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: