StratoPCB

The Stratocaster pickguard PCB project and its local KiCad MCP application runtime live together in this repository.

Layout

• stratocaster-pickguard.kicad_pro / .kicad_pcb — the KiCad project.
• mcp-server/ — a portable copy of the MCP application source needed to inspect, edit, and route this board through KiCad.

Local MCP setup (macOS)

1. Install KiCad 10 and enable Preferences → Plugins → Enable IPC API Server, then open the board in PCB Editor.

2. Create a Python environment from KiCad's bundled Python and install the backend dependencies:

   /Applications/KiCad/KiCad.app/Contents/Frameworks/Python.framework/Versions/Current/bin/python3 -m venv mcp-server/venv --system-site-packages
   source mcp-server/venv/bin/activate
   pip install -r mcp-server/requirements.txt
   npm run install:mcp
   npm run build
   

3. Launch the server with npm run mcp:ipc. It deliberately stays in the foreground because MCP uses the launching client's stdio.

mcp-server/docs/PLATFORM_GUIDE.md and mcp-server/docs/CLIENT_CONFIGURATION.md contain the broader setup and client configuration references. mcp-server/UPSTREAM_SETUP.md is the source project's complete setup guide.