Borrowing it
Nothing to install: this file belongs to Bov27/MCPkicad. Take a copy, put it at the same path in your own repository, and replace the rules that are about this project with yours.
curl -O https://raw.githubusercontent.com/Bov27/MCPkicad/beta-test/CLAUDE.mdgit clone --depth 1 https://github.com/Bov27/MCPkicadWrote this? Show the measurements
A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.
[](https://agentmods.dev/instructions/bov27/mcpkicad/claude-md)<a href="https://agentmods.dev/instructions/bov27/mcpkicad/claude-md"><img src="https://agentmods.dev/badge/instructions/bov27/mcpkicad/claude-md/github.svg" alt="Measured on agentmods" height="20"></a>Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.
<a href="https://agentmods.dev/instructions/bov27/mcpkicad/claude-md"><img src="https://agentmods.dev/badge/instructions/bov27/mcpkicad/claude-md.svg" alt="Reviewed on agentmods" width="80" height="20"></a>What it costs to keep this loaded
Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.
| Model | Per session | Once invoked |
|---|---|---|
| Fable 5.1 | $0.09320 | $0.09320 |
| Opus 5.5 | $0.03728 | $0.03728 |
| Sonnet 5.5 | $0.01864 | $0.01864 |
| Haiku 4.5 | $0.00932 | $0.00932 |
Grade A, and why
MCPkicad CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 2mo ago.
A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.
Nothing flagged
None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.
How it starts
The opening of the file, as written. The whole thing — 403 lines — stays where its author put it; the contents beside it link to each section on GitHub.
KiCAD MCP Server
What This Project Is
An MCP (Model Context Protocol) server that enables AI assistants to design PCBs and schematics in KiCAD. It has a TypeScript frontend (MCP server, tool registration, STDIO transport) and a Python backend (KiCAD interaction via pcbnew SWIG API and kicad-skip for schematics).
Architecture
AI Client (Claude, etc.)
↕ STDIO (MCP protocol)
TypeScript Server (src/)
↕ JSON over stdin/stdout (child process)
Python Backend (python/)
↕ pcbnew SWIG API / kicad-skip / S-expression manipulation
KiCAD files (.kicad_pcb, .kicad_sch, .kicad_pro)
TypeScript Layer (src/)
index.ts— Entry point, starts MCP serverserver.ts—KiCADMcpServerclass, spawns Python child process (with auto-restart on crash), registers all tools/resources/promptsconfig.ts— Zod-validated config loading fromconfig/logger.ts— Logger (stderr only; stdout reserved for MCP protocol)tools/*.ts— Tool registration using@modelcontextprotocol/sdk. Each tool callscallKicadScript(command, args)which sends JSON to the Python processresources/*.ts— MCP resource handlersprompts/*.ts— MCP prompt templates
Python Layer (python/)
kicad_interface.py— Main entry point. Reads JSON commands from stdin, dispatches to command handlers, returns JSON on stdout. Supports IPC and SWIG backends. WARNING: This is a 7000+ line god file with duplicated pin math in 7 handlers. When fixing pin calculations, check ALL inline pin calc sites, not justpin_locator.py. Contains shared geometry parser_parse_schematic_geometry(), content-based static helpers_delete_component_from_content(),_edit_component_in_content(), T-junction helpers_point_on_wire_segment()and_find_connected_wires(), and a sharedPinLocatorinstance (self.pin_locator).commands/— Command handlers organized by domain:schematic.py—SchematicManager(create schematic, template-based)component_schematic.py—ComponentManager(add/edit/delete/move components using kicad-skip + dynamic symbol loading).add_componentsnaps to 1.27mm grid.remove_componentuses text-based balanced-paren deletion (not kicad-skip_elements).connection_schematic.py—ConnectionManager(wires, net labels, connections)wire_manager.py—WireManager(thin delegation layer tosexp_writer.py)pin_locator.py—PinLocator(pin position discovery via S-expr parsing, handles rotation + mirror)sexp_writer.py— Text-based insertion/deletion for .kicad_sch files (wires, labels, junctions, no-connects, wire splitting). All writes usef.flush()+os.fsync(). Has_to_content/_from_contentvariants for all operations includingadd_label_to_content,add_polyline_wire_to_content,split_wire_at_point_in_content,delete_no_connect_from_content. Wire placement (add_wire,add_polyline_wire) now auto-detects T-junctions and adds junction dots viaauto_add_t_junctions(). Also has_parse_wire_segments(),_parse_existing_junctions(), and_point_on_wire_mid()helpers for T-junction spatial analysis.net_analysis.py— Net-level analysis using union-find graph.build_net_graph()builds complete pin→net mapping in O(W+L+P) via union-find with spatial-indexed T-junction detection. Query functions:get_component_nets,get_net_components,get_pin_net_name,export_netlist_summary,validate_component_connections,find_shorted_nets,find_single_pin_nets.component.py— Board-level component operations (via pcbnew)routing.py— Trace routing (via pcbnew)board.py,board/*.py— Board operations (layers, outline, size, 2D view)project.py— Project creation/managementlibrary.py,library_schematic.py,library_symbol.py— Library operationsdynamic_symbol_loader.py— Loads symbols from KiCAD libraries at runtime._extract_symbol_blockhandles both multi-line and single-line.kicad_symfiles via balanced-paren traversal.footprint.py— Footprint operationsexport.py— Export (Gerber, PDF, SVG, BOM, 3D, etc.)design_rules.py— DRC rulesjlcpcb.py,jlcpcb_parts.py,jlcsearch.py— JLCPCB integrationdatasheet_manager.py— Datasheet URL extractionsymbol_creator.py— Custom symbol creationsvg_import.py— SVG logo import
kicad_api/— Backend abstraction (SWIG vs IPC)base.py— Abstract base classswig_backend.py— pcbnew SWIG backendipc_backend.py— KiCAD IPC API backend (experimental)factory.py— Backend factory
schemas/tool_schemas.py— Python-side tool schema definitionsresources/— Resource definitionsutils/— Platform detection, KiCAD process managementtemplates/— Schematic templates (used bycreate_schematic)
What this file has done since we first saw it
Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.
- 2mo ago First seen · 403 lines · 9,320 tokens per session scan A b3262cca31ef
MCPkicad CLAUDE.md is an instructions file published in the GitHub repository Bov27/MCPkicad (0 stars, last pushed 5mo ago), licensed MIT. It adds 9,320 tokens to every session, about $0.0373 per session on Opus 5.5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.
MCPkicad CLAUDE.md compared with instructions from other repositories
| Mod | Type | Stars | Last push | Licence | Scan | Tokens | Works with |
|---|---|---|---|---|---|---|---|
| MCPkicad CLAUDE.mdBov27/MCPkicad | Instructions file | 0 | 5mo ago | MIT | A | 9,320 | Claude Code |
| vscode buildNext.instructions.mdmicrosoft/vscode | Instructions file | 196k | today | MIT | A | 9,719 | GitHub Copilot |
| next.js AGENTS.mdvercel/next.js | Instructions file | 144k | today | MIT | A | 8,130 | Codex, OpenCode |
| vscode oss-third-party-notices.instructions.mdmicrosoft/vscode | Instructions file | 196k | today | MIT | A | 5,685 | GitHub Copilot |
| langchain AGENTS.mdlangchain-ai/langchain | Instructions file | 150k | today | MIT | A | 4,680 | Codex, OpenCode |
| deepseek-harness AGENTS.mddeepseek-ai/deepseek-harness | Instructions file | 283k | today | MIT | A | 4,342 | Codex, OpenCode |
| vscode copilot-instructions.mdmicrosoft/vscode | Instructions file | 196k | today | MIT | A | 3,153 | GitHub Copilot |