reflow-mcp
A typed Model Context Protocol server that exposes KiCad 10 EDA workflows to language-model clients through validated tool calls.
Install
uvx [email protected] --help
pip install reflow-mcp
npm install -g @oaslananka/reflow-mcp
docker run --rm ghcr.io/oaslananka/reflow-mcp:1.0.0 --help
Quickstart
{
"mcpServers": {
"reflow": {
"command": "uvx",
"args": ["[email protected]", "serve"]
}
}
}
Client examples live under examples/clients/ and docs/integration/.
Capabilities
- Project lifecycle, snapshots, variants, and metadata.
- PCB read, write, analysis, zone, and design-rule tools.
- Schematic read/write/edit tools through the schematic API layer.
- DRC, ERC, DFM, EMC, signal integrity, and power integrity gates.
- Manufacturing and export pipelines for standard fabrication artifacts.
- Simulation, routing, library, catalog, and component helper tools.
Configuration
| Variable | Default | Description |
|---|---|---|
REFLOW_MCP_KICAD_CLI |
auto-detect | Optional kicad-cli path. |
REFLOW_MCP_PROJECT_ROOT_ALLOWLIST |
current directory | Filesystem roots tools may access. |
REFLOW_MCP_REQUIRE_KICAD |
true |
Refuse server startup when KiCad is unavailable. |
REFLOW_MCP_MINIMUM_KICAD_VERSION |
10.0.0 |
Minimum accepted KiCad version. |
REFLOW_MCP_OTEL_ENABLED |
false |
Enable OpenTelemetry export. |
REFLOW_MCP_OTEL_ENDPOINT |
unset | OTLP endpoint when telemetry is enabled. |
Security Model
All path arguments are resolved through the allowlist before use. Symlinks are followed and the resolved target must remain below an allowed root. See docs/security/ for the threat model and disclosure process.
Compatibility
- Python
>=3.13,<3.15. - KiCad 10.x for full EDA execution.
- Windows, macOS, and Linux hosted runners in CI.
Versioning
The first publishable version of this reset repository is 1.0.0. Release Please manages future versions from conventional commits.
License
MIT.
