docs: document KiCAD MCP as host-only in AGENTS.md

Add host-only requirement to KiCAD MCP description.
Add KICAD_HOST and KICAD_PORT environment variables
with default values for Docker Desktop compatibility.
Add development note about KiCAD host installation requirement.

💘 Generated with Crush

Assisted-by: GLM-4.7 via Crush <crush@charm.land>

AGENTS.md

@@ -9,7 +9,7 @@ This document tracks the AI agents and MCP servers configured in this project.
 #### Design & Engineering (3 servers)
 | Service | Container Name | Status | Description |
 |---------|---------------|--------|-------------|
-| kicad-mcp | KNELDevStack-AIMW-kicad-mcp | In Progress | PCB design automation with 64 tools, JLCPCB integration |
+| kicad-mcp | KNELDevStack-AIMW-kicad-mcp | Documented | PCB design automation with 64 tools, JLCPCB integration (host-only) |
 | blender-mcp | KNELDevStack-AIMW-blender-mcp | Pending | 3D modeling, materials, scenes, AI 3D model generation |
 | freecad-mcp | KNELDevStack-AIMW-freecad-mcp | Pending | CAD modeling, Python execution, parts library |
 
@@ -125,6 +125,7 @@ Common environment variables required for MCP servers:
 | postizz-mcp | `POSTIZ_API_KEY`, `POSTIZ_URL` |
 | matomo-mcp | `MATOMO_URL`, `MATOMO_TOKEN` |
 | elasticsearch-mcp | `ELASTICSEARCH_URL`, `ELASTICSEARCH_USERNAME`, `ELASTICSEARCH_PASSWORD` |
+| kicad-mcp | `KICAD_HOST` (default: host.docker.internal), `KICAD_PORT` (default: 5555) |
 | context7-mcp | `UPSTASH_REDIS_REST_URL`, `UPSTASH_REDIS_REST_TOKEN` |
 
 ## Quick Start
@@ -156,6 +157,7 @@ docker compose stop <service-name>
 - Service names are lowercase for Docker Compose compatibility
 - Each agent is validated individually before moving to the next
 - Vendor directory is gitignored to avoid committing cloned repositories
+- **KiCAD MCP** is host-only - requires KiCAD to be installed on host machine and connects via TCP
 
 ## Validation Checklist
 

STATUS.md

@@ -4,7 +4,7 @@ Tracking the setup and validation of MCP/LSP servers via Docker Compose.
 
 | Repository | Status | Notes |
 |------------|--------|-------|
-| KiCAD-MCP-Server | Pending | |
+| KiCAD-MCP-Server | Documented | Host-only - requires KiCAD installed on host. Connects via TCP to KICAD_HOST:KICAD_PORT |
 | freecad-mcp | Pending | |
 | blender-mcp | Pending | |
 | context7 | Pending | |
@@ -54,4 +54,4 @@ To rebuild a server after changes:
 docker compose build --no-cache <service-name>
 ```
 
-Note: Use lowercase service names from the compose file. Container names will still be prefixed with CDS-AIMW-.
+Note: Use lowercase service names from the compose file. Container names will still be prefixed with KNELDevStack-AIMW-.

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