{
  "markdown": "# altium-designer-mcp\n\n[![CI](https://github.com/embedded-society/altium-designer-mcp/actions/workflows/ci_main.yml/badge.svg)](https://github.com/embedded-society/altium-designer-mcp/actions/workflows/ci_main.yml)\n[![codecov](https://codecov.io/gh/embedded-society/altium-designer-mcp/branch/main/graph/badge.svg)](https://app.codecov.io/gh/embedded-society/altium-designer-mcp)\n\n**Let an AI build your Altium libraries — it does the engineering, this tool writes the files.**\n\nAn MCP server that gives AI assistants (Claude Code, Claude Desktop, Cursor, Antigravity, VS Code Copilot — any MCP client) file I/O\nand primitive-placement tools for Altium Designer `.PcbLib` (footprint) and `.SchLib` (symbol)\nlibraries — so the AI can create and maintain *any* component, not just pre-programmed packages.\n\n---\n\n## The Problem\n\nBuilding Altium component libraries by hand is slow and repetitive — every footprint means\nlooking up IPC-7351B pad sizes, courtyards, and silkscreen, then placing each primitive by\nhand. AI assistants are excellent at exactly that reasoning, but they **cannot write Altium's\nbinary `.PcbLib`/`.SchLib` files** — an undocumented OLE compound format that is easy to\ncorrupt, and Altium silently refuses to open a malformed file.\n\n| Approach | Problem |\n|----------|---------|\n| Draw every footprint by hand in Altium | Slow and repetitive; the AI can't touch the file |\n| Ask an AI to emit the binary file directly | It produces a corrupt file Altium won't open |\n| Pre-programmed footprint generators | Only the package types someone coded in advance |\n\n---\n\n## The Core Idea\n\n**The AI handles the intelligence. The tool handles file I/O.**\n\n| Responsibility | Owner |\n|---------------|-------|\n| IPC-7351B calculations | AI |\n| Package layout decisions | AI |\n| Style choices | AI |\n| Datasheet interpretation | AI |\n| Reading/writing Altium files | This tool |\n| Primitive placement | This tool |\n| STEP model attachment | This tool |\n\nThis means the AI can create **any footprint** — not just pre-programmed package types.\nSee [docs/VISION.md](docs/VISION.md) for the full architectural rationale.\n\n---\n\n## Who Is This For?\n\nAnyone who **builds or maintains Altium component libraries** and uses an **MCP-capable AI\nassistant**. The AI does the engineering (datasheet → dimensions → style); this server lets it\nread and write the actual `.PcbLib` / `.SchLib` files.\n\n| If you… | Then… |\n|---------|-------|\n| Use Claude Code, Claude Desktop, Cursor, Antigravity, VS Code + Copilot — [any MCP client](docs/CLIENT_SETUP.md) — and design in Altium | ✅ This is for you |\n| Want pre-baked generators for a fixed set of packages | ❌ Not this — the point is *any* component |\n| Don't use Altium | ❌ Not applicable |\n\n---\n\n## Quick Start\n\n> **[Client Setup](docs/CLIENT_SETUP.md)** — verified configuration for Claude Code, Claude\n> Desktop, Google Antigravity, Cursor, VS Code, GitHub Copilot CLI, Windsurf, Cline, Roo Code,\n> Kiro, JetBrains, Zed, Gemini CLI, Codex CLI, Continue, Goose, OpenCode and any other stdio\n> MCP client, plus troubleshooting — on **Windows**, **Linux**, and **macOS**.\n>\n> **[Using the server](docs/USAGE.md)** — what to ask for once it is connected: example\n> workflows, prompts and tips, identical for every client.\n\n---\n\n## How It Works\n\n```text\n┌─────────────────────────────────────────────────────────────────────────────┐\n│  AI-ASSISTED COMPONENT CREATION                                             │\n│                                                                             │\n│  Engineer                    AI                         MCP Server          │\n│    │                         │                              │               │\n│    │  \"Create 0603 resistor\" │                              │               │\n│    ├────────────────────────►│                              │               │\n│    │                         │                              │               │\n│    │                         │  AI reasons about:           │               │\n│    │                         │  • IPC-7351B pad sizes       │               │\n│    │                         │  • Courtyard margins         │               │\n│    │                         │  • Silkscreen/symbol style   │               │\n│    │                         │                              │               │\n│    │                         │  write_pcblib(primitives)    │               │\n│    │                         ├─────────────────────────────►│               │\n│    │                         │                              │ Writes        │\n│    │                         │                              │ .PcbLib +     │\n│    │                         │  write_schlib(symbol)        │ .SchLib files │\n│    │                         ├─────────────────────────────►│               │\n│    │                         │◄─────────────────────────────┤               │\n│    │                         │  { status: \"success\" }       │               │\n│    │                         │                              │               │\n│    │  \"Done! Footprint       │                              │               │\n│    │   and symbol created\"   │                              │               │\n│    │◄────────────────────────┤                              │               │\n│                                                                             │\n└─────────────────────────────────────────────────────────────────────────────┘\n```\n\n---\n\n## MCP Tools\n\nThe server exposes **34 tools**, working on both `.PcbLib` (footprints) and\n`.SchLib` (symbols). Every tool's full parameters and examples live in\n**[docs/TOOLS.md](docs/TOOLS.md)** — this is the categorised overview.\n\n### Read & write\n\n| Tool | Purpose |\n|------|---------|\n| [`read_pcblib`](docs/TOOLS.md#read_pcblib) | Read footprints from a `.PcbLib`. |\n| [`write_pcblib`](docs/TOOLS.md#write_pcblib) | Write footprints to a `.PcbLib`. |\n| [`read_schlib`](docs/TOOLS.md#read_schlib) | Read symbols from a `.SchLib`. |\n| [`write_schlib`](docs/TOOLS.md#write_schlib) | Write symbols to a `.SchLib`. |\n\n### Inspect & visualise\n\n| Tool | Purpose |\n|------|---------|\n| [`list_components`](docs/TOOLS.md#list_components) | List component names (paginated). |\n| [`get_component`](docs/TOOLS.md#get_component) | Get one component's full data. |\n| [`search_components`](docs/TOOLS.md#search_components) | Search across libraries by regex/glob. |\n| [`component_exists`](docs/TOOLS.md#component_exists) | Check whether components exist. |\n| [`render_footprint`](docs/TOOLS.md#render_footprint) | ASCII-art preview of a footprint. |\n| [`render_symbol`](docs/TOOLS.md#render_symbol) | ASCII-art preview of a symbol. |\n| [`extract_style`](docs/TOOLS.md#extract_style) | Extract styling from an existing library. |\n\n### Compare\n\n| Tool | Purpose |\n|------|---------|\n| [`diff_libraries`](docs/TOOLS.md#diff_libraries) | Compare two library files. |\n| [`compare_components`](docs/TOOLS.md#compare_components) | Diff two specific components. |\n\n### Edit in place\n\n| Tool | Purpose |\n|------|---------|\n| [`update_component`](docs/TOOLS.md#update_component) | Update a component, preserving its position. |\n| [`update_pad`](docs/TOOLS.md#update_pad) | Update one pad's properties. |\n| [`update_primitive`](docs/TOOLS.md#update_primitive) | Update one primitive (track/arc/text/fill/region). |\n| [`batch_update`](docs/TOOLS.md#batch_update) | Batch updates across all components. |\n| [`reorder_components`](docs/TOOLS.md#reorder_components) | Reorder components in a library. |\n| [`manage_schlib_parameters`](docs/TOOLS.md#manage_schlib_parameters) | List/get/set/remove SchLib parameters. |\n| [`manage_schlib_footprints`](docs/TOOLS.md#manage_schlib_footprints) | Manage footprint links in SchLib symbols. |\n\n### Manage components\n\n| Tool | Purpose |\n|------|---------|\n| [`delete_component`](docs/TOOLS.md#delete_component) | Delete one or more components. |\n| [`copy_component`](docs/TOOLS.md#copy_component) | Duplicate a component within a library. |\n| [`rename_component`](docs/TOOLS.md#rename_component) | Rename a component (atomic). |\n| [`copy_component_cross_library`](docs/TOOLS.md#copy_component_cross_library) | Copy a component to another library. |\n| [`bulk_rename`](docs/TOOLS.md#bulk_rename) | Pattern-based multi-rename. |\n\n### Library operations\n\n| Tool | Purpose |\n|------|---------|\n| [`merge_libraries`](docs/TOOLS.md#merge_libraries) | Merge multiple libraries into one. |\n| [`write_libpkg`](docs/TOOLS.md#write_libpkg) | Write a `.LibPkg` project grouping libraries for IntLib compilation. |\n| [`export_library`](docs/TOOLS.md#export_library) | Export to JSON/CSV. |\n| [`import_library`](docs/TOOLS.md#import_library) | Import from JSON (inverse of export). |\n| [`validate_library`](docs/TOOLS.md#validate_library) | Validate for common issues. |\n| [`repair_library`](docs/TOOLS.md#repair_library) | Remove orphaned data. |\n| [`extract_step_model`](docs/TOOLS.md#extract_step_model) | Extract embedded STEP 3D models. |\n\n### Backups & safety\n\n| Tool | Purpose |\n|------|---------|\n| [`list_backups`](docs/TOOLS.md#list_backups) | List automatic backups. |\n| [`restore_backup`](docs/TOOLS.md#restore_backup) | Restore from a backup. |\n\n## Primitive Types\n\n### Footprint Primitives (PcbLib)\n\n| Primitive | Description |\n|-----------|-------------|\n| **Pad** | SMD or through-hole pad with designator, position, size, shape, layer (see Pad Shapes below) |\n| **Via** | Vertical interconnect with layer span, hole size, and thermal relief |\n| **Track** | Line segment on any layer (silkscreen, assembly, etc.) |\n| **Arc** | Arc or circle on any layer |\n| **Region** | Filled polygon (courtyard, copper pour) |\n| **Text** | Text string with font, size, position, layer |\n| **Fill** | Filled rectangle on any layer |\n| **ComponentBody** | 3D model reference (embedded STEP models) |\n\n#### Pad Shapes and Pin 1 Indicator\n\nThe `shape` property on pads controls the copper shape. Use this to indicate pin 1:\n\n| Shape | Value | Usage |\n|-------|-------|-------|\n| Rectangle | `\"rectangle\"` | **Pin 1 indicator** — use for the first pad to distinguish it visually |\n| Rounded Rectangle | `\"rounded_rectangle\"` | Default for SMD pads (most common) |\n| Round | `\"round\"` or `\"circle\"` | Circular pads, default for through-hole (both values are equivalent) |\n| Oval | `\"oval\"` | Oblong pads for constrained spaces |\n| Octagonal | `\"octagonal\"` | Eight-sided pads (chamfered corners) |\n\n**Example — marking pin 1 with a rectangular pad:**\n\n```json\n{\n    \"pads\": [\n        { \"designator\": \"1\", \"x\": -0.75, \"y\": 0, \"width\": 0.9, \"height\": 0.95, \"shape\": \"rectangle\" },\n        { \"designator\": \"2\", \"x\": 0.75, \"y\": 0, \"width\": 0.9, \"height\": 0.95, \"shape\": \"rounded_rectangle\" }\n    ]\n}\n```\n\nThis follows the IPC-7351 convention where pin 1 has a distinct shape (typically rectangular or square corners) while other pads use rounded corners.\n\n### Symbol Primitives (SchLib)\n\n| Primitive | Description |\n|-----------|-------------|\n| **Pin** | Component pin with name, designator, electrical type, orientation |\n| **Rectangle** | Filled or unfilled rectangle (component body) |\n| **RoundRect** | Rounded rectangle with corner radii |\n| **Line** | Single line segment |\n| **Polyline** | Multiple connected line segments |\n| **Polygon** | Filled polygon with border and fill colours |\n| **Arc** | Arc or circle |\n| **Pie** | Filled circular sector (arc geometry plus fill) |\n| **Image** | Embedded or linked raster picture with a bounding box |\n| **Ellipse** | Ellipse or circle (filled or unfilled) |\n| **EllipticalArc** | Elliptical arc segment with fractional radii |\n| **Bezier** | Cubic Bezier curve (4 control points) |\n| **Label** | Text string (RECORD=4) — the only free text on a symbol |\n| **IeeeSymbol** | IEEE symbol glyph (RECORD=3): a dot, a clock, an active-low input, … |\n| **TextFrame** | Bordered multi-line text box (word-wrap, alignment) |\n| **Parameter** | Component parameter (Value, Part Number, etc.) |\n| **FootprintModel** | Reference to a footprint in a PcbLib |\n\n### Standard Altium Layers\n\nCommon layers for footprints (each has a Bottom equivalent):\n\n| Layer | Usage |\n|-------|-------|\n| Top Layer | Copper pads (SMD) |\n| Bottom Layer | Bottom copper pads |\n| Multi-Layer | Through-hole pads (all copper layers) |\n| Top Overlay | Silkscreen |\n| Top Paste | Solder paste stencil |\n| Top Solder | Solder mask openings |\n| Top Assembly | Assembly outline (documentation) |\n| Top Courtyard | Courtyard boundary (IPC-7351) |\n| Top 3D Body | 3D model outline |\n\nAdditional layers supported:\n\n| Layer | Usage |\n|-------|-------|\n| Mid-Layer 1–30 | Internal copper layers |\n| Internal Plane 1–16 | Power/ground planes |\n| Mechanical 1–32 | User-defined mechanical layers |\n| Drill Guide | Drill hole markers |\n| Drill Drawing | Drill chart/table |\n| Keep-Out Layer | Routing exclusion zones |\n\nA layer may be named as Altium spells it (`Top Overlay`, `Mechanical 13`) or in camel\ncase (`TopOverlay`, `Mechanical13`), in any case; every tool accepts the same spellings.\n\n---\n\n## Installation\n\n**Prebuilt binaries** for Linux (x86_64), macOS (aarch64) and Windows (x86_64) are on the\n[Releases page](https://github.com/embedded-society/altium-designer-mcp/releases) — each\narchive bundles a setup README plus [`docs/CLIENT_SETUP.md`](docs/CLIENT_SETUP.md), which\nwires the server into every MCP client we know of.\n\n**Claude Desktop users** need no archive at all: install the one-click extension\n`altium-designer-mcp.mcpb` from the same page (older builds: the identical\n`altium-designer-mcp.dxt`) via Settings → Extensions → Advanced settings →\nInstall Extension… — see [CLIENT_SETUP.md § Claude Desktop](docs/CLIENT_SETUP.md#claude-desktop).\n\n**In a container** — for a Linux box, a NAS or a CI job that generates libraries into a\nmounted folder (Altium itself never needs to be inside): the repository's `Dockerfile`\nproduces the same `--locked` release build as the published binaries.\n\n```bash\ndocker build -t altium-designer-mcp .\ndocker run -i --rm -v /path/to/libraries:/libraries altium-designer-mcp\n```\n\nThe mounted `/libraries` folder is the container's whole allow-list. In a client's\nconfiguration that is `\"command\": \"docker\"` with\n`\"args\": [\"run\", \"-i\", \"--rm\", \"-v\", \"/path/to/libraries:/libraries\", \"altium-designer-mcp\"]`.\n\nTo build from source instead, see\n[CONTRIBUTING.md § Development Setup](CONTRIBUTING.md#development-setup); an optimised\nbinary comes from `cargo build --release` and lands at `target/release/altium-designer-mcp`.\n\n### Verifying a downloaded release\n\nReleased archives are built by GitHub Actions and carry a signed\n[SLSA build provenance](https://slsa.dev/) attestation, so a download can be traced\nback to the workflow run and commit that produced it:\n\n```bash\ngh attestation verify <archive> --repo embedded-society/altium-designer-mcp\nsha256sum --check --ignore-missing SHA256SUMS.txt\n```\n\nThe binaries are not code-signed, so Windows SmartScreen and macOS Gatekeeper warn on\nfirst run (on macOS, right-click → Open). The attestation is the stronger check.\nSee [docs/RELEASING.md](docs/RELEASING.md) for how releases are produced.\n\n### Command-Line Usage\n\n```bash\naltium-designer-mcp [OPTIONS] [CONFIG_FILE]\n```\n\n| Option | Description |\n|--------|-------------|\n| `CONFIG_FILE` | Path to configuration file (optional, uses default location if omitted) |\n| `--allow <DIR>...` | Grant access to library folders directly (repeatable). Adds to the config file's `allowed_paths`, and works with no config file at all — the other settings then take their defaults |\n| `-v`, `--verbose` | Increase logging verbosity (`-v` info, `-vv` debug, `-vvv` trace) |\n| `-q`, `--quiet` | Decrease logging verbosity (only show errors) |\n| `-h`, `--help` | Print help information |\n| `-V`, `--version` | Print version information |\n\n### Connecting an AI client\n\nEvery MCP client needs the same two absolute paths — the binary and your config file — and\ndiffers only in where they are written. The standard block most clients read:\n\n```json\n{\n    \"mcpServers\": {\n        \"altium\": {\n            \"command\": \"/usr/local/bin/altium-designer-mcp\",\n            \"args\": [\"/home/you/.altium-designer-mcp/config.json\"]\n        }\n    }\n}\n```\n\nWhere that goes for Claude Desktop, Cursor, VS Code, Windsurf, Cline, Zed, JetBrains,\nGemini CLI, Codex CLI and the rest — and what to do when a client cannot see the server —\nis in [docs/CLIENT_SETUP.md](docs/CLIENT_SETUP.md). Use absolute paths: clients do not\nsearch `PATH` or expand `~` for you.\n\n---\n\n## Configuration\n\nThe server reads one JSON file — or none: `altium-designer-mcp --allow <DIR>` grants\nfolders on the command line and runs on defaults for everything else, which is how the\nClaude Desktop extension starts it. Configuration file location:\n\n- **Linux/macOS:** `~/.altium-designer-mcp/config.json`\n- **Windows:** `%USERPROFILE%\\.altium-designer-mcp\\config.json`\n\n```json\n{\n    \"allowed_paths\": [\n        \"/path/to/your/altium/libraries\",\n        \"/another/library/path\"\n    ],\n    \"logging\": {\n        \"level\": \"warn\"\n    }\n}\n```\n\n### Configuration Options\n\n| Option | Description |\n|--------|-------------|\n| `allowed_paths` | Array of directory paths where library files can be accessed; `--allow` adds to it (default when neither grants anything: the current working directory) |\n| `logging.level` | Log level: trace, debug, info, warn, error (default: warn) |\n| `logging.audit_log_path` | Path to an append-only JSON-lines audit log of destructive operations (default: null — no audit log is written) |\n| `rate_limit.max_burst` | Maximum burst of mutating operations before throttling; read-only tools are never rate limited (default: 120) |\n| `rate_limit.refill_per_sec` | Token-bucket refill rate for mutating operations, in tokens per second (default: 30.0) |\n\n---\n\n## STEP Model Integration\n\nSTEP models are **attached**, not generated. The tool links existing STEP files to footprints.\n\n```json\n{\n    \"step_model\": {\n        \"filepath\": \"./3d-models/0603.step\",\n        \"x_offset\": 0,\n        \"y_offset\": 0,\n        \"z_offset\": 0,\n        \"rotation\": 0\n    }\n}\n```\n\n### Embedded vs External Models\n\nAltium supports two ways to reference 3D models:\n\n| Type | Storage | Portability |\n|------|---------|-------------|\n| **Embedded** | STEP data stored inside the .PcbLib file | Fully portable — the model travels with the library |\n| **External** | File path reference to a .step file on disk | Not portable — requires the file to exist at the referenced path |\n\nWhen copying or merging components between libraries:\n\n- **Embedded models** travel with the component — `copy_component_cross_library` and\n  `merge_libraries` both copy the referenced model streams into the target (a model shared by\n  several footprints is copied once), so the bodies still resolve after the move.\n- **External model references**: `copy_component_cross_library` removes them with a warning by\n  default, since a path relative to the source library rarely resolves elsewhere — pass\n  `preserve_external_paths=true` to keep them. `merge_libraries` carries them unchanged.\n\nEmbedding a model in the source library is the reliable way to keep 3D data through any copy.\n\n### Extracting Embedded Models\n\nUse `extract_step_model` to extract embedded STEP data from a library:\n\n```json\n{\n    \"name\": \"extract_step_model\",\n    \"arguments\": {\n        \"filepath\": \"./MyLibrary.PcbLib\",\n        \"output_path\": \"./extracted_model.step\"\n    }\n}\n```\n\nFor parametric 3D model generation, a dedicated mechanical MCP server is planned as a future project.\n\n---\n\n## Automatic Backups\n\nBefore any destructive operation (delete, update, merge, batch update), the server automatically\ncreates a timestamped backup of the target file. Backups use the format:\n\n```text\nMyLibrary.PcbLib.20260125_143022.bak\n```\n\n**Backup retention:** Only the 5 most recent backups per file are kept. Older backups are\nautomatically removed to prevent unbounded disk usage.\n\n**Operations that create backups:**\n\n- `delete_component`\n- `update_component`\n- `update_pad`\n- `update_primitive`\n- `rename_component`\n- `copy_component`\n- `copy_component_cross_library` (target file)\n- `merge_libraries` (target file)\n- `reorder_components`\n- `batch_update`\n- `bulk_rename`\n- `repair_library`\n- `manage_schlib_parameters`\n- `manage_schlib_footprints`\n- `write_pcblib` / `write_schlib` (when overwriting)\n- `import_library` (when overwriting)\n- `restore_backup` (the current file, before the chosen backup replaces it)\n\n**Managing backups:** Use `list_backups` to view available backups and `restore_backup` to\nrecover from a previous version.\n\n**Dry-run support:** These operations support `dry_run=true` to preview changes\nwithout modifying files:\n\n- `delete_component` — preview which components would be deleted\n- `update_component` — preview component replacement changes\n- `update_pad` / `update_primitive` — preview property changes\n- `bulk_rename` — preview name changes\n- `repair_library` — preview orphaned references to remove\n- `batch_update` — preview library-wide updates\n- `copy_component` / `rename_component` / `merge_libraries`\n\n---\n\n## Notes\n\n### Long Component Names\n\nComponent names longer than 31 characters are supported. The OLE Compound File format limits\nstorage names to 31 characters, so longer names are automatically truncated internally while\nthe full name is preserved in component parameters. This is handled transparently — you can\nuse any length component name and it will be preserved on read/write roundtrips.\n\n---\n\n## Privacy Policy\n\n`altium-designer-mcp` is a local tool and collects nothing.\n\n- **Data collection**: none. The server has no network access, no telemetry and no\n  analytics; it never contacts any service, including this project's.\n- **Usage and storage**: it reads and writes only the library files inside the folders\n  you grant (`allowed_paths` or `--allow`), plus the timestamped `.bak` copies it makes\n  beside them before a change. The optional audit log (`logging.audit_log_path`) is a\n  local file you choose, holding tool names, file names and outcomes — never library\n  contents.\n- **Third-party sharing**: none. Nothing leaves your machine.\n- **Data retention**: the files and backups stay until you delete them; backups are\n  capped at the five most recent per library.\n- **Contact**: <matejg03@gmail.com>, or a [GitHub issue](https://github.com/embedded-society/altium-designer-mcp/issues)\n  for anything that need not be private.\n\n---\n\n## Documentation\n\n| For… | Read |\n|------|------|\n| Wiring the server into your AI client | [docs/CLIENT_SETUP.md](docs/CLIENT_SETUP.md) — one section per client |\n| What to ask for once it is connected | [docs/USAGE.md](docs/USAGE.md) — workflows, prompts, tips |\n| Telling the AI how to use it well | [docs/AGENT_GUIDE.md](docs/AGENT_GUIDE.md) (paste into a project brief), [docs/AI_WORKFLOW.md](docs/AI_WORKFLOW.md) |\n| Every tool, parameter and example | [docs/TOOLS.md](docs/TOOLS.md); error messages in [docs/errors.md](docs/errors.md) |\n| Why it is built this way | [docs/VISION.md](docs/VISION.md), [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) |\n| The file formats, byte by byte | [docs/PCBLIB_FORMAT.md](docs/PCBLIB_FORMAT.md), [docs/SCHLIB_FORMAT.md](docs/SCHLIB_FORMAT.md) |\n| Security model and threat analysis | [docs/SECURITY.md](docs/SECURITY.md) (reporting: [SECURITY.md](SECURITY.md)) |\n| How releases are built and verified | [docs/RELEASING.md](docs/RELEASING.md) |\n\n---\n\n## Contributing\n\nContributions welcome! See [CONTRIBUTING.md](CONTRIBUTING.md) for guidelines.\n\n- Follow the style guide in [STYLE.md](STYLE.md)\n- Security issues: see [SECURITY.md](SECURITY.md)\n\n---\n\n## Development\n\n```bash\ncargo test\n```\n\nWrite-path tests generate their own data programmatically; reader tests parse the committed\nAltium-authored golden fixtures (see [Sample Files](#sample-files)). Temporary files are\ncreated in `.tmp/` (git-ignored) and automatically cleaned up.\n\nThe full build, formatting, and lint commands are canonical in\n[CONTRIBUTING.md § Development Setup](CONTRIBUTING.md#development-setup).\n\n---\n\n## Licence\n\nCopyright (C) 2026 The Embedded Society <https://github.com/embedded-society/altium-designer-mcp>.\n\nGNU General Public License v3.0 — see [LICENCE](LICENCE).\n\n---\n\n## Links\n\n- [MCP Specification](https://modelcontextprotocol.io/)\n- [Report an Issue](https://github.com/embedded-society/altium-designer-mcp/issues)\n\n---\n\n## Sample Files\n\nAltium-authored sample libraries are committed under `scripts/samples/` as **golden fixtures**:\nthe reader tests (`tests/samples_pcblib.rs`, `tests/samples_schlib.rs`) parse them in CI as\nground truth. The PowerShell/DelphiScript tooling that (re)generates them needs a real Altium\ninstallation and is manual-only.\n\nSee [scripts/README.md](scripts/README.md) for details on the sample files and the on-site tooling.\n\n---\n\n## Prior Art & Acknowledgements\n\nThis project stands on the shoulders of several excellent open-source efforts, and we're grateful\nfor each:\n\n- **[AltiumSharp](https://github.com/issus/AltiumSharp)** (MIT) — the most complete open Altium\n  reader/writer. Used as the authoritative reference (its DTOs, binary serialisation code, and golden\n  `TestData`) for verifying our binary format against ground truth.\n- **[pyAltiumLib](https://github.com/ChrisHoyer/pyAltiumLib)** — an independent Python reader, used\n  as our CI **readability oracle** (`tests/integration/`) to check that generated files actually\n  parse.\n- **[python-altium](https://github.com/vadmium/python-altium)** — early Altium format\n  documentation.\n- **[coffeenmusic/altium-mcp](https://github.com/coffeenmusic/altium-mcp)** (MIT) — an MCP server\n  that drives the **live** Altium application. It's the complement to this project (we generate and\n  edit library files *offline*; it controls a running session). We adapted its RunScript launch +\n  file-based bridge pattern for our on-site Altium automation\n  ([`scripts/altium/`](scripts/altium/)).\n",
  "bytes": 26020,
  "sha": "9f355c3d4d328c9dfc08b050e70f503fe51e8cf5a1d3689392320122f189e73a",
  "repo_slug": "embedded-society/altium-designer-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_embedded_society_altium_design_3ed201ff/readme"
}