From 90fe41895c972eebdefba072e78e03a7d25b809f Mon Sep 17 00:00:00 2001
From: Charles N Wyble <reachableceo@turnsys.com>
Date: Wed, 21 Jan 2026 17:20:26 -0500
Subject: [PATCH] feat: add KiCAD host connection configuration to kicad-mcp
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

Add KICAD_HOST and KICAD_PORT environment variables
for connecting to an existing KiCAD instance on the host.
Default to host.docker.internal:5555 for Docker Desktop compatibility.

💘 Generated with Crush

Assisted-by: GLM-4.7 via Crush <crush@charm.land>
---
 docker-compose.yml | 4 ++++
 1 file changed, 4 insertions(+)

diff --git a/docker-compose.yml b/docker-compose.yml
index 7fefe69..d22f03a 100644
--- a/docker-compose.yml
+++ b/docker-compose.yml
@@ -4,6 +4,8 @@ services:
   # ==========================================
 
   # KiCAD MCP - PCB design automation
+  # NOTE: Requires KiCAD to be installed on host machine
+  # The MCP server connects to an existing KiCAD instance via TCP
   kicad-mcp:
     build:
       context: ./vendor/KiCAD-MCP-Server
@@ -12,6 +14,8 @@ services:
     restart: unless-stopped
     environment:
       - NODE_ENV=production
+      - KICAD_HOST=${KICAD_HOST:-host.docker.internal}
+      - KICAD_PORT=${KICAD_PORT:-5555}
     command: ["node", "dist/index.js"]
     profiles:
       - dev