Cadence Allegro PCB Files

A small Model Context Protocol (stdio) server for working with Cadence Allegro design drops on disk: locate .brd files, list directories, read text assets (drill, README, BOM CSV), and inspect Gerber zip contents.

Repo: github.com/dcmcshan/allegro-mcp

git clone https://github.com/dcmcshan/allegro-mcp.git ~/GitHub/allegro-mcp

This server does not embed Allegro PCB Editor. Optional Allegro batch commands can be added later if allegro or pcbenv is on PATH and you set the usual Cadence environment variables.

Install

cd ~/GitHub/allegro-mcp
uv sync

Run manually:

uv run python -m allegro_mcp.server

Cursor

Add to ~/.cursor/mcp.json (see example in this repo’s install notes or your global config):

"allegro-mcp": {
  "command": "/Users/YOU/GitHub/allegro-mcp/.venv/bin/python",
  "args": ["-m", "allegro_mcp.server"],
  "cwd": "/Users/YOU/GitHub/allegro-mcp",
  "env": {}
}

Or with uv:

"allegro-mcp": {
  "command": "uv",
  "args": ["run", "--directory", "/Users/YOU/GitHub/allegro-mcp", "python", "-m", "allegro_mcp.server"],
  "cwd": "/Users/YOU/GitHub/allegro-mcp"
}

Restart Cursor after editing MCP config.

Tools

Tool	Purpose
find_board_files	Glob for *.brd (or custom pattern) under a root
list_directory	List paths with optional glob
read_text_file	Read capped UTF-8 text
zip_list_contents	List a Gerber/manufacturing zip
zip_read_text_member	Read one text member from a zip
allegro_related_env	Show Cadence-related env vars visible to the server

License

MIT