SynthPilot

Talk to your AI. Watch it drive Vivado.

Website · Docs · oh-my-fpga skills · PyPI · Changelog

English | 简体中文

SynthPilot is an MCP server that lets your AI assistant (Claude, Cursor, Cline, …) control Xilinx Vivado for FPGA development — create projects, write and lint RTL, run synthesis/implementation, close timing, configure IP & Block Designs, run simulations, and program hardware — all by describing what you want, in plain language.

It runs locally: your RTL never leaves your machine. 500+ tools cover the whole FPGA flow, and a free methodology layer (oh-my-fpga) turns them into one-sentence outcomes.

Used by engineers from AMD, Tsinghua / Fudan / SJTU and the Chinese Academy of Sciences (CAS), FPGA vendor Fudan Microelectronics (复旦微), and lidar leaders Hesai (禾赛) and Benewake (北醒).

How it works

 AI editor (Claude / Cursor / Cline / …)
        │   MCP (stdio)
        ▼
   SynthPilot   ──TCP:9999──▶   Vivado (Tcl server)

The AI calls SynthPilot tools; SynthPilot drives Vivado over a local socket and returns structured results (timing metrics, utilization, error summaries, waveforms …) back to the AI.

See it in action

You: "Create an Artix-7 project, add this counter, run synthesis, and show me the timing."

The AI: create_project → add_source_file → run_synthesis → report_timing_summary → reports WNS/TNS and flags any failing paths — no Tcl, no wizard clicking.

Quick start

uv tool install synthpilot      # requires uv — https://docs.astral.sh/uv/
synthpilot setup                # guided, one-command onboarding

synthpilot setup does the rest for you: it detects Vivado and installs the Tcl server, activates your license, and registers SynthPilot in your AI editor — no hand-editing JSON (Claude Code, Claude Desktop, Cursor, Codex), then runs an end-to-end health check. Something off later? synthpilot doctor diagnoses it and synthpilot doctor --fix self-heals.

Prefer to wire the MCP client up by hand?

{ "mcpServers": { "synthpilot": { "command": "synthpilot" } } }

Works with Claude Desktop / Claude Code, Cursor, Cline, Codex, and other MCP clients.

Skills & methodology — oh-my-fpga

500 tools give your AI capability — not strategy. oh-my-fpga is a free, open companion that adds the methodology layer: named, expert workflows like "close timing", "audit CDC", "bring up a Zynq SoC". You describe the outcome; the AI runs the right tools in the right order, with the right safety rails (verify before claiming, never fake-pass a real violation).

• Claude Code — /plugin marketplace add LNC0831/oh-my-fpga then /plugin install oh-my-fpga
• Cursor · Codex · Claude Desktop — the same 13 workflows ship as MCP prompts built into SynthPilot (1.3.0+); pick them from your client's / menu.

→ github.com/LNC0831/oh-my-fpga

Editions

	Free	Pro	Max
Tools	40 core	~475	all 500+
Project / synth / impl / basic reports	✅	✅	✅
IP config · Block Design · Simulation · Linter · async runs	—	✅	✅
Devices	1	2	3

The methodology layer (oh-my-fpga) is free for everyone, on every edition. Pricing, a ¥1 / 7-day trial, and team / offline / academic editions are on synthpilot.dev.

Requirements

• Xilinx Vivado 2018.1+ (Windows or Linux)
• An MCP-capable AI client
• uv (Python 3.10+ is fetched automatically)

Links

• 🌐 Website & pricing — https://synthpilot.dev
• 🧠 oh-my-fpga skills — https://github.com/LNC0831/oh-my-fpga
• 📦 PyPI — https://pypi.org/project/synthpilot/
• 📖 Docs — https://synthpilot.dev/docs.html
• 🗒️ Changelog

License

SynthPilot is a proprietary commercial product. This repository hosts its public documentation and marketing materials only — the software itself is distributed via PyPI. The RTL you process stays on your machine; SynthPilot does not upload your design sources. (The companion oh-my-fpga skill pack is separate and MIT-licensed.)

---

简体中文

对你的 AI 说一句话,它替你操作 Vivado。

SynthPilot 是一个 MCP 服务器,让你的 AI 助手(Claude、 Cursor、Cline…)用自然语言控制 Xilinx Vivado 做 FPGA 开发——建项目、写/查 RTL、 跑综合与实现、收敛时序、配置 IP 与 Block Design、跑仿真、烧录硬件。

全程本地运行,你的 RTL 不出本机。500+ 工具覆盖完整 FPGA 流程,再加一层免费的方法论 (oh-my-fpga),把它们变成一句话的结果。

已被 AMD、清华 / 复旦 / 上海交大 与 中科院(CAS) 的工程师,国产 FPGA 厂商 复旦微,以及激光雷达企业 禾赛、北醒 使用。

工作原理

 AI 编辑器 (Claude / Cursor / Cline / …)
        │   MCP (stdio)
        ▼
   SynthPilot   ──TCP:9999──▶   Vivado (Tcl 服务器)

AI 调用 SynthPilot 的工具,SynthPilot 通过本地 socket 驱动 Vivado,并把结构化结果 (时序指标、资源利用、错误摘要、波形…)返回给 AI。

一个例子

你:"建一个 Artix-7 工程,加入这个计数器,跑综合,把时序给我看看。"

AI:create_project → add_source_file → run_synthesis → report_timing_summary → 报告 WNS/TNS 并标出违例路径——不写 Tcl,不点向导。

快速开始

uv tool install synthpilot      # 需要 uv —— https://docs.astral.sh/uv/
synthpilot setup                # 一条命令,引导式上手

synthpilot setup 替你把剩下的事做完:检测 Vivado 并安装 Tcl 服务器、激活授权,并 把 SynthPilot 注册进你的 AI 编辑器——免手改 JSON(Claude Code、Claude Desktop、 Cursor、Codex),最后跑一遍端到端健康检查。后面出问题?synthpilot doctor 自检、 synthpilot doctor --fix 自愈。

想手动配置 MCP 客户端?

{ "mcpServers": { "synthpilot": { "command": "synthpilot" } } }

支持 Claude Desktop / Claude Code、Cursor、Cline、Codex 等 MCP 客户端。

技能与方法论 —— oh-my-fpga

500 个工具给 AI 的是能力,不是策略。 oh-my-fpga 是一个免费开源的配套,补上方法论 这一层:一组命名的专家工作流,比如 "收敛时序"、"审查 CDC"、"搭一个 Zynq SoC"。你说 出想要的结果,AI 就按正确顺序调用正确的工具,带着正确的安全护栏(先验证再下结论,绝不为了 让数字变绿而假装通过)。

• Claude Code —— /plugin marketplace add LNC0831/oh-my-fpga 然后 /plugin install oh-my-fpga
• Cursor · Codex · Claude Desktop —— 同样这 13 个工作流作为 MCP prompts 内置在 SynthPilot(1.3.0+),在客户端的 / 菜单里选用。

→ github.com/LNC0831/oh-my-fpga

档位

	免费版	Pro	Max
工具数	40 基础	约 475	全部 500+
工程 / 综合 / 实现 / 基础报告	✅	✅	✅
IP 配置 · Block Design · 仿真 · Linter · 异步执行	—	✅	✅
设备数	1	2	3

方法论层(oh-my-fpga)对所有人、所有档位永久免费。 定价、¥1 / 7 天试用,以及团队 / 离线 / 高校版,见 synthpilot.dev。

环境要求

• Xilinx Vivado 2018.1+(Windows 或 Linux)
• 一个支持 MCP 的 AI 客户端
• uv(Python 3.10+ 会自动获取)

链接

• 🌐 官网与定价 —— https://synthpilot.dev
• 🧠 oh-my-fpga 技能包 —— https://github.com/LNC0831/oh-my-fpga
• 📦 PyPI —— https://pypi.org/project/synthpilot/
• 📖 文档 —— https://synthpilot.dev/docs.html
• 🗒️ 更新日志

授权

SynthPilot 是专有商业产品。本仓库仅托管其公开文档与宣传材料,软件本体经 PyPI 分发。 你处理的 RTL 始终留在本机,SynthPilot 不上传你的设计源码。(配套的 oh-my-fpga 技能包是独立的 MIT 开源项目。)