# KiCad MCP Pro [Health: Active]

**Category:** 💻 Developer Tools  
**Repository:** https://github.com/oaslananka/kicad-studio-kit  
**GitHub Stars:** 16  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/kicad-mcp-pro-2

## Description
A Model Context Protocol server for KiCad EDA workflows.

## Claude Desktop Quick Installation
Heuristic fallback — verify the package name and runner against the repository README before running it. Uses `npx` (confidence: low):

```json
"mcpServers": {
  "kicad-mcp-pro": {
    "command": "npx",
    "args": ["-y","kicad-mcp-pro-2"]
  }
}
```

## Documentation & README

<div align="center">

# KiCad Studio Kit

**VS Code extension repository for KiCad Studio workflows.**
Extension-side MCP discovery, configuration, compatibility metadata, and user experience.

<p>
  <a href="https://github.com/oaslananka/kicad-studio-kit/actions/workflows/ci.yml"><img src="https://github.com/oaslananka/kicad-studio-kit/actions/workflows/ci.yml/badge.svg" alt="CI status"></a>
  <a href="https://github.com/oaslananka/kicad-studio-kit/actions/workflows/codeql.yml"><img src="https://github.com/oaslananka/kicad-studio-kit/actions/workflows/codeql.yml/badge.svg" alt="CodeQL status"></a>
  <a href="https://github.com/oaslananka/kicad-studio-kit/actions/workflows/security.yml"><img src="https://github.com/oaslananka/kicad-studio-kit/actions/workflows/security.yml/badge.svg" alt="Security status"></a>
  <a href="https://codecov.io/gh/oaslananka/kicad-studio-kit"><img src="https://codecov.io/gh/oaslananka/kicad-studio-kit/branch/main/graph/badge.svg" alt="Codecov coverage"></a>
  <a href="https://scorecard.dev/viewer/?uri=github.com/oaslananka/kicad-studio-kit"><img src="https://api.scorecard.dev/projects/github.com/oaslananka/kicad-studio-kit/badge" alt="OpenSSF Scorecard"></a>
  <a href="https://www.bestpractices.dev/projects/13405"><img src="https://www.bestpractices.dev/projects/13405/badge" alt="OpenSSF Best Practices"></a>
</p>

<p>
  <a href="https://open-vsx.org/extension/oaslananka/kicadstudiokit"><img src="https://img.shields.io/open-vsx/v/oaslananka/kicadstudiokit?label=Open%20VSX" alt="Open VSX version"></a>
  <a href="https://marketplace.visualstudio.com/items?itemName=oaslananka.kicadstudiokit"><img src="https://img.shields.io/badge/VS%20Marketplace-install-blue" alt="Install from Visual Studio Marketplace"></a>
  <a href="https://github.com/oaslananka/kicad-studio-kit/blob/main/LICENSE"><img src="https://img.shields.io/badge/license-MIT-blue" alt="MIT license"></a>
  <a href="https://oaslananka.github.io/kicad-studio-kit/"><img src="https://img.shields.io/badge/docs-site-blue" alt="Documentation site"></a>
  <a href="https://deepwiki.com/oaslananka/kicad-studio-kit"><img src="https://deepwiki.com/badge.svg" alt="Ask DeepWiki"></a>
</p>

<p>
  <a href="https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/best-practices-evidence.md">Best Practices evidence</a> ·
  <a href="https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/GOVERNANCE.md">Governance</a> ·
  <a href="https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/ROADMAP.md">Roadmap</a> ·
  <a href="https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/SUPPORT.md">Support</a>
</p>

<p>
  <a href="https://www.buymeacoffee.com/oaslananka"><img src="https://img.shields.io/badge/Buy%20me%20a%20coffee-support-FFDD00?logo=buymeacoffee&logoColor=000000&labelColor=FFDD00&color=111111" alt="Buy me a coffee"></a>
</p>

</div>

KiCad Studio Kit is the VS Code extension repository. The MCP server is
developed and released separately. This repository owns only the extension-side
MCP discovery, configuration, compatibility metadata, and user experience — see
[ADR 0009](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/adr/0009-split-kicad-mcp-pro-into-separate-repository.md) and
[repository structure](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/architecture/repo-structure.md).

The coverage badge reports the configured Jest unit denominator, not every
shipped source file. Exclusion ownership and the separate critical-module
ratchet are documented in [the testing strategy](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/testing-strategy.md#coverage-scope-inventory).

This repository contains:

- the KiCad Studio VS Code extension (`apps/vscode-extension`) — the only released product here;
- private shared test infrastructure (`packages/test-harness`, `packages/kicad-fixtures`);
- the extension-side MCP integration contract and compatibility metadata.

The KiCad MCP Pro server (`kicad-mcp-pro`) — its Python source, npm launcher,
container image, and MCP Registry listing — lives in
[KiCad MCP Pro](https://oaslananka.github.io/kicad-mcp-pro/).

## Repository maturity and standards

This repository tracks Solo-maintainer Professional OSS / Mature OSS readiness through [the repository maturity report](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/repo-maturity-report.md), [OpenSSF evidence](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/openssf-evidence.md), and [OpenSSF gap analysis](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/openssf-gap-analysis.md). Gold/foundation-grade maturity is intentionally not claimed for the current solo-maintainer model; branch protection and release evidence remain the practical Professional OSS focus.

## Version Baseline

<!-- release-surface:start -->
<!-- Generated from apps/vscode-extension/package.json. Run `corepack pnpm run release:surface` to refresh. -->

This repository's local release surface is:

- VS Code extension: `oaslananka.kicadstudiokit` (`1.15.0`)

The Python package `kicad-mcp-pro`, container image, and MCP Registry listing
are released from [KiCad MCP Pro](https://oaslananka.github.io/kicad-mcp-pro/).
<!-- release-surface:end -->

## KiCad Compatibility

KiCad Studio Kit treats KiCad `10.0.x` as the primary tested line, keeps KiCad
`9.x` as deprecated best-effort compatibility after upstream EOL, and keeps
KiCad `8.x` as deprecated file-level compatibility. The canonical matrix, tested patch versions, CI
coverage level, and feature gates are maintained in
[docs/support-matrix.md](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/support-matrix.md) and `compatibility.yaml`.

## Local Validation

```powershell
corepack enable
corepack pnpm run dev:doctor
corepack pnpm install --frozen-lockfile
corepack pnpm --dir apps/vscode-extension exec playwright install chromium
corepack pnpm run check:forbidden-refs
corepack pnpm run check:version
corepack pnpm --filter kicadstudiokit run check
corepack pnpm --filter kicadstudiokit run package

```

Product-scoped entrypoints are available from the root:

```powershell
corepack pnpm run check:kicad-studio

corepack pnpm --dir packages/test-harness run check
corepack pnpm run check:protocol-schemas
corepack pnpm run check:compatibility-contract
corepack pnpm run check:dev-doctor
```

Python/MCP server checks run from the
[KiCad MCP Pro](https://oaslananka.github.io/kicad-mcp-pro/) repository.

For a reproducible VS Code Dev Containers or GitHub Codespaces environment, use
the checked-in [devcontainer configuration](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/devcontainer.md). The container
sets up Node, pnpm, Python, uv, Playwright, shellcheck, actionlint, GitHub CLI,
and best-effort KiCad CLI support for root checks and MCP tests. For a
least-privilege VPS without a container daemon, use the checked-in
[rootless validation-host profile](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/validation-host.md).

## Install

Install the extension from the Visual Studio Marketplace or Open VSX, or build
it locally:

```powershell
corepack enable
corepack pnpm install --frozen-lockfile
corepack pnpm run package:kicad-studio
```

## Usage

Open a workspace containing a KiCad project and use the KiCad Studio activity
bar views and commands. See [docs/getting-started.md](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/getting-started.md)
for the guided workflow and [docs/extension/commands.md](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/extension/commands.md)
for the command catalog.

## Architecture

- [Searchable documentation site](https://oaslananka.github.io/kicad-studio-kit/)
- [Repository structure](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/architecture/repo-structure.md)
- [Product boundaries](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/architecture/product-boundaries.md)
- [Release model](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/architecture/release-model.md)
- [Testing strategy](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/testing-strategy.md)
- [Dev container](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/devcontainer.md)
- [Rootless validation host](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/validation-host.md)
- [KiCad fixture corpus](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/kicad-fixture-corpus.md)
- [Integration model](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/integration/kicad-studio-mcp.md)
- [Agent onboarding](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/agents/index.md)
- [MCP client config examples](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/examples/mcp-clients/README.md)
- [VS Code MCP workspace example](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/.vscode/mcp.example.json)

## Examples

- [Examples overview](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/examples/README.md)
- [LED Basic KiCad example](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/examples/led-basic/README.md)
- [MCP Workflow Demo](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/examples/mcp-demo/README.md)

## Publishing

Publishing is handled by GitHub Actions workflows under `.github/workflows`. External setup for environments, marketplace secrets, and trusted publishers is documented in [docs/publishing.md](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/publishing.md).
The structured preview (beta) program and tester feedback loop for the stable `1.x` line are documented in [docs/beta-program.md](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/beta-program.md).

## Maintenance

Dependency update policy, dashboard triage, and security-update handling are documented in [docs/dependency-lifecycle.md](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/dependency-lifecycle.md).
Compatibility support states and release gates are documented in [docs/support-matrix.md](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/support-matrix.md).
Canonical repository and portfolio workflow status are recorded in [CANONICAL.md](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/CANONICAL.md), [.repo-health.yaml](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/.repo-health.yaml), and [docs/reusable-workflows.md](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/reusable-workflows.md).
Telemetry and error reporting are opt-in, disabled by default, and documented in [docs/telemetry.md](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/docs/telemetry.md).

## Contributing

Read [CONTRIBUTING.md](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/CONTRIBUTING.md) and run `corepack pnpm run check` before
opening a pull request.

## License

KiCad Studio Kit is available under the [MIT License](https://github.com/oaslananka/kicad-studio-kit/blob/HEAD/LICENSE).