Vivado MCP
Enables AI agents to control AMD Vivado for FPGA design workflows, including starting/stopping Vivado sessions, opening projects, running synthesis and implementation, generating bitstreams, checking timing and resource reports, inspecting design hierarchy and signals, running simulations, and executing TCL commands.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Vivado MCP Open the lab3 Vivado project, run synthesis, and show resource usage"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Vivado MCP: AI로 Vivado 조작하기 (Windows 학생용)
AI(Claude Code, Codex, Gemini)에게 말로 시키면 Vivado가 알아서 움직이게 해 주는 도구입니다.
"lab3 프로젝트 열고 합성 돌려줘"
"타이밍 만족했어?"
"시뮬레이션 1us 돌리고 count 신호 값 알려줘"아래 순서대로 위에서부터 하나씩 따라 하면 됩니다. 건너뛰지 마세요. 회색 상자 안의 명령어는 복사해서 붙여넣기만 하면 됩니다. 직접 타이핑하지 마세요.
한눈에 보기
단계 | 할 일 | 걸리는 시간 |
STEP 0 | PowerShell 여는 법 익히기 | 1분 |
STEP 1 | 필요한 프로그램 설치 | 10~20분 |
STEP 2 | 이 프로그램 다운로드 | 1분 |
STEP 3 |
| 2~3분 |
STEP 4 | AI 켜서 확인 | 1분 |
Vivado는 이미 설치되어 있다고 가정합니다. (수업 시간에 설치한 그 Vivado)
Related MCP server: vivado-mcp
STEP 0. PowerShell 여는 법
앞으로 "PowerShell을 연다"는 말이 나오면 이렇게 하세요.
키보드의 Windows 키를 누릅니다.
powershell이라고 입력합니다.Windows PowerShell이 나오면 Enter를 누릅니다.
파란색 또는 검은색 창이 뜨면 성공입니다.
명령어 붙여넣는 법: 아래 회색 상자 오른쪽 위의 복사 버튼을 누르고, PowerShell 창에서 마우스 오른쪽 클릭 (또는 Ctrl + V) 한 뒤 Enter.
"창을 닫고 새로 연다" 는 말이 나오면 PowerShell 창의 X 버튼으로 닫고, 위 1~3번을 다시 하면 됩니다.
STEP 1. 필요한 프로그램 설치
1-1. PowerShell 스크립트 허용 (모두 필수, 처음 한 번만)
PowerShell을 열고 붙여넣기 → Enter:
Set-ExecutionPolicy -Scope CurrentUser RemoteSigned -Force아무 메시지도 안 나오면 정상입니다.
1-2. Python, Git 설치 (모두 필수)
같은 창에 아래 두 줄을 한 줄씩 붙여넣고 Enter. 각각 끝날 때까지 기다리세요.
winget install -e --id Python.Python.3.12 --override "/quiet InstallAllUsers=0 PrependPath=1" --accept-source-agreements --accept-package-agreementswinget install -e --id Git.Git --accept-source-agreements --accept-package-agreements중간에 "이 앱이 디바이스를 변경하도록 허용하시겠어요?" 창이 뜨면 예를 누르세요.
PowerShell 창을 닫고 새로 연 뒤 확인:
python --versionPython 3.12.x 처럼 나오면 성공입니다.
1-3. AI 도구 설치 (셋 중 하나만 골라서)
어떤 걸 쓸지 모르겠으면 수업에서 안내한 것을 고르세요.
PowerShell에 붙여넣기 → Enter:
irm https://claude.ai/install.ps1 | iex창을 닫고 새로 연 뒤 아래를 입력하고, 안내에 따라 로그인합니다.
claude로그인이 끝나면 /exit 를 입력해서 나옵니다.
먼저 Node.js를 설치합니다.
winget install -e --id OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements창을 닫고 새로 연 뒤:
npm install -g @openai/codex설치가 끝나면 아래를 입력하고, Sign in with ChatGPT를 골라 로그인합니다.
codex로그인이 끝나면 /quit 를 입력해서 나옵니다.
Codex 데스크톱 앱을 쓰는 경우에도 이 설치 과정은 그대로 따라 하면 됩니다. (설정이 앱과 공유됩니다)
먼저 Node.js를 설치합니다.
winget install -e --id OpenJS.NodeJS.LTS --accept-source-agreements --accept-package-agreements창을 닫고 새로 연 뒤:
npm install -g @google/gemini-cli설치가 끝나면 아래를 입력하고, Login with Google을 골라 로그인합니다.
gemini로그인이 끝나면 /quit 를 입력해서 나옵니다.
STEP 2. 이 프로그램 다운로드
PowerShell을 열고 아래를 한 줄씩 붙여넣기 → Enter:
cd C:\git clone https://github.com/binghin2/Vivado_mcp_student.git vivado_mcp이제 C:\vivado_mcp 폴더가 생겼습니다.
중요: 이 폴더는 지우거나 옮기지 마세요. 지우면 AI가 Vivado를 못 씁니다.
STEP 3. 설치 프로그램 실행
파일 탐색기를 엽니다. (
Windows 키 + E)주소창에
C:\vivado_mcp를 입력하고 Enter.setup.bat파일을 더블클릭합니다."Windows의 PC 보호" 창이 뜨면 추가 정보 → 실행을 누르세요.
검은 창에서 설치가 진행됩니다. 건드리지 말고 기다리세요. (2~3분)
화면이 이렇게 나오면 성공입니다.
[1/6] Python 확인
[OK] Python 3.12
[2/6] Vivado 찾기
[OK] C:\AMDDesignTools\2026.1\Vivado\bin
[3/6] Vivado 를 PATH 에 등록
[OK] 등록 완료
[4/6] vivado_mcp 설치 (1~2분 걸릴 수 있습니다)
[OK] 설치 완료
[5/6] Vivado 실행 테스트 (30초~1분 걸릴 수 있습니다)
[OK] Vivado 가 정상적으로 실행됩니다.
[6/6] AI 도구에 등록 (Claude Code / Codex / Gemini)
[OK] Claude Code
[OK] Codex
[OK] Gemini
==============================================
설치 완료!
==============================================설치하지 않은 AI 도구는
[건너뜀]으로 나와도 괜찮습니다.[실패]가 보이면 아래 문제가 생겼을 때를 보세요."Vivado 를 자동으로 찾지 못했습니다" 가 나오면 여기를 보세요.
마지막에 계속하려면 아무 키나 누르십시오... 가 나오면 아무 키나 눌러 창을 닫습니다.
STEP 4. AI 켜서 확인
열려 있는 PowerShell 창을 전부 닫고, 새 PowerShell을 엽니다.
먼저 작업용 폴더를 만들고 그 안으로 이동합니다. (한 줄씩 붙여넣기)
mkdir C:\work -Forcecd C:\work앞으로 Vivado 프로젝트도
C:\work안에 만들면 편합니다. (예:C:\work\lab3)
그다음 내가 설치한 AI를 실행합니다.
쓰는 AI | 입력할 명령 |
Claude Code |
|
Codex |
|
Gemini |
|
AI가 켜지면 /mcp 를 입력하고 Enter.
목록에 vivado 가 보이면 성공입니다.
이제 이렇게 입력해 보세요.
Vivado 세션 시작하고 버전 알려줘AI가 "이 도구를 실행해도 될까요?" 라고 물어보면 허용 (Yes / Allow) 을 고르세요. 매번 묻는 게 귀찮으면 "항상 허용 (Always allow / don't ask again)" 을 골라도 됩니다.
사용 예시
그냥 한국어로 시키면 됩니다. 복사해서 써 보세요.
Vivado 세션 시작해줘C:\work\lab3\lab3.xpr 프로젝트 열어줘합성 돌리고 끝나면 리소스 사용량 보여줘구현까지 돌리고 타이밍 만족하는지 확인해줘타이밍 위반 나는 경로 상위 5개 보여주고 원인 설명해줘비트스트림 생성해줘tb_counter 테스트벤치로 시뮬레이션 1us 돌리고 count 신호 값 알려줘Vivado 세션 종료해줘꼭 알아둘 것
처음에 "Vivado 세션 시작해줘" 를 해야 합니다. Vivado가 켜지는 데 30초~1분 걸립니다.
합성, 구현은 오래 걸립니다. 중간에 "진행 상황 알려줘" 라고 물어보면 됩니다.
다 쓰면 "Vivado 세션 종료해줘" 를 꼭 하세요. 안 하면 Vivado가 컴퓨터 메모리를 계속 차지합니다.
프로젝트 폴더 경로에 한글이나 띄어쓰기가 없게 하세요. (Vivado 자체 제약)
좋은 예:
C:\work\lab3나쁜 예:
C:\Users\홍길동\바탕 화면\실습 3
문제가 생겼을 때
winget 을(를) 인식할 수 없습니다
Microsoft Store를 열고 앱 설치 관리자를 검색해서 업데이트(또는 설치)하세요. 그다음 PowerShell을 새로 엽니다.
python 을 입력했더니 Microsoft Store가 열려요
Python이 설치되지 않은 상태입니다. 1-2를 다시 하고, 창을 닫고 새로 연 뒤 확인하세요.
"이 시스템에서 스크립트를 실행할 수 없으므로..." 라는 빨간 글씨
1-1을 하지 않은 것입니다. 1-1을 하고 다시 시도하세요.
claude / codex / gemini 을(를) 인식할 수 없습니다
설치 직후라면 창을 닫고 새로 열어 보세요. 그래도 안 되면 1-3을 다시 하세요.
Vivado 를 자동으로 찾지 못했습니다
Vivado가 기본 위치가 아닌 곳에 설치된 경우입니다.
파일 탐색기에서
vivado.bat파일을 찾습니다. (보통...\Vivado\2023.2\bin같은 폴더 안)그 폴더를 연 상태에서 주소창을 클릭하고
Ctrl + C로 경로를 복사합니다.설치 창의
경로:부분에 마우스 오른쪽 클릭으로 붙여넣고 Enter.
/mcp 에 vivado 가 안 보여요
PowerShell 창을 전부 닫고 새로 열어서 다시 해 보세요.
그래도 안 되면
C:\vivado_mcp\setup.bat을 한 번 더 더블클릭하세요.AI 도구를
setup.bat보다 나중에 설치했다면 반드시setup.bat을 다시 실행해야 합니다.
그래도 안 돼요
setup.bat 실행 화면 전체를 캡처해서 조교/교수님께 보내 주세요.
(참고) 수동 등록 방법
setup.bat 이 자동으로 해 주는 내용입니다. 보통은 볼 필요 없습니다.
Claude Code
claude mcp add --scope user vivado -- python -m vivado_mcpCodex — C:\Users\<내이름>\.codex\config.toml 맨 아래에 추가:
[mcp_servers.vivado]
command = "python"
args = ["-m", "vivado_mcp"]
startup_timeout_sec = 60
tool_timeout_sec = 600Gemini 수동 등록 — C:\Users\<내이름>\.gemini\settings.json 에 mcpServers 항목 추가:
{
"mcpServers": {
"vivado": {
"command": "python",
"args": ["-m", "vivado_mcp"],
"timeout": 600000
}
}
}기존 내용이 있으면 지우지 말고 mcpServers 부분만 합쳐 넣으세요.
setup.bat 은 기존 설정 파일을 수정하기 전에 .bak 백업 파일을 만들어 둡니다.
삭제하기
PowerShell에서:
claude mcp remove --scope user vivado
python -m pip uninstall -y vivado-mcp그다음 C:\vivado_mcp 폴더를 지우면 됩니다.
(Codex/Gemini는 위 설정 파일에서 vivado 부분을 지우세요.)
사용 가능한 기능 (참고)
도구 이름을 외울 필요는 없습니다. 하고 싶은 걸 말로 시키면 AI가 알아서 고릅니다.
분류 | 할 수 있는 일 |
세션 | Vivado 켜기/끄기, 상태 확인 |
프로젝트 |
|
설계 흐름 | 합성, 구현, 비트스트림 생성 |
리포트 | 타이밍 요약, 위반 경로, 리소스 사용량, 클럭, 경고/에러 메시지 |
설계 조회 | 모듈 계층, 포트, 넷, 셀 |
시뮬레이션 | 시뮬레이션 실행/재시작, 신호 값 읽기, 파형 추가, 브레이크포인트 |
고급 | 임의 TCL 명령 실행, 전체 리포트 저장 |
원본 프로젝트: coreyhahn/vivado_mcp (Windows 지원: newtonsart/vivado_mcp) · 영문 원본 문서: README.en.md · License: MIT (LICENSE)
Available Tools
40 toolsadd_breakpointB
Add a simulation breakpoint on a signal condition
Inputs: signal (required), condition.
add_signals_to_waveB
Add signals to the waveform viewer
Inputs: signals (required).
check_session_healthA
Check if Vivado session is responsive and recover if needed. Use this if commands are timing out or behaving unexpectedly.
Inputs: auto_recover.
close_projectB
Close the current project
Inputs: no named parameters.
close_simulationA
Close the current simulation
Inputs: no named parameters.
generate_bitstreamB
Generate bitstream for the implemented design
Inputs: no named parameters.
generate_full_reportA
Generate a full Vivado report to a file. Use when inline reports are truncated or you need the complete output.
Inputs: report_type (required), options, output_file.
get_cellsB
Search for cells (instances) in the design
Inputs: limit, pattern.
get_clocksA
Get clock information and constraints
Inputs: no named parameters.
get_design_hierarchyB
Get the design hierarchy (modules and instances)
Inputs: max_depth, instance_pattern.
get_host_statusA
Get status of this Vivado MCP server host including hostname, free memory, and session state. If free memory is below 64GB, use vivado-snoke instead.
Inputs: no named parameters.
get_messagesB
Get synthesis/implementation messages (errors, warnings)
Inputs: severity.
get_netsB
Search for nets in the design
Inputs: limit, pattern.
get_portsA
Get top-level ports of the design
Inputs: no named parameters.
get_project_infoC
Get information about the currently open project
Inputs: no named parameters.
get_scopesC
List available scopes (hierarchy) in the simulation
Inputs: parent.
get_signal_valueB
Get the current value of a signal in simulation
Inputs: signal (required), radix.
get_signal_valuesB
Get current values of multiple signals matching a pattern
Inputs: pattern (required), radix.
get_simulation_messagesC
Get simulation log messages (errors, warnings, info)
Inputs: severity.
get_simulation_objectsA
List simulation objects (signals, variables) in a scope
Inputs: scope, filter.
get_simulation_timeA
Get the current simulation time
Inputs: no named parameters.
get_timing_pathsA
Get timing paths for failing or critical paths. Returns structured summary (slack, source, dest, clocks) by default. Use generate_full_report for verbose path details.
Inputs: clock, to_pin, through, from_pin, +4 more.
get_timing_summaryA
Get timing summary (WNS, TNS, WHS, THS). Returns parsed metrics only by default. Use generate_full_report for raw output.
Inputs: report_type, detail_level.
get_utilizationA
Get resource utilization (LUT, FF, BRAM, DSP, IO). Returns parsed metrics only by default. Use generate_full_report for hierarchical details.
Inputs: detail_level, hierarchical, module_filter, threshold_percent.
launch_simulationC
Launch behavioral simulation (xsim). Opens the simulator and loads the design.
Inputs: mode.
list_feature_requestsA
List all feature requests that have been submitted
Inputs: no named parameters.
open_projectB
Open a Vivado project (.xpr file)
Inputs: project_path (required).
read_report_sectionC
Read a section of a previously generated report file
Inputs: file_path, num_lines, report_id, start_line, +1 more.
remove_breakpointsB
Remove all breakpoints
Inputs: no named parameters.
request_featureA
Request a new feature or capability for the Vivado MCP server. Use this when you encounter a limitation or wish you had a tool that doesn't exist.
Inputs: title (required), description (required), priority, use_case.
restart_simulationA
Restart the simulation from time 0
Inputs: no named parameters.
run_implementationB
Run implementation (place and route) on the current project
Inputs: jobs, timeout.
run_simulationC
Run the simulation for a specified time
Inputs: time (required).
run_synthesisD
Run synthesis on the current project
Inputs: jobs, timeout.
run_tclA
Execute a raw TCL command in Vivado. Use for advanced operations not covered by other tools.
Inputs: command (required).
session_statusB
Get status and statistics of the current Vivado session
Inputs: no named parameters.
set_simulation_topB
Set the top module for simulation
Inputs: top_module (required), fileset.
start_sessionA
Start a persistent Vivado TCL session. Must be called before other commands.
Inputs: vivado_path.
step_simulationB
Step the simulation by a delta cycle or time step
Inputs: count.
stop_sessionA
Stop the Vivado TCL session and free resources
Inputs: no named parameters.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 40 tools
The tools are mostly cleanly separated by workflow stage: session management, project control, build steps, reporting, design queries, and simulation. A few boundaries are slightly fuzzy, such as get_signal_value versus get_signal_values, session_status versus check_session_health, and the report-generation/read-report pair, but descriptions make the intended use clear.
Names are consistently snake_case and predominantly follow a verb_noun pattern, e.g. run_synthesis, get_timing_summary, launch_simulation, generate_bitstream. Minor deviations like session_status and the singular/plural get_signal_value(s) are readable but keep it from perfect consistency.
Forty tools is heavy for a single MCP surface, even for a complex domain like Vivado. Several simulation and reporting helpers could likely be consolidated or made optional, and the large surface increases selection burden.
The surface covers the core FPGA flow from opening a project through synthesis, implementation, bitstream generation, reporting, and simulation, with run_tcl as an escape hatch. Notable gaps remain around project creation, file/constraint management, IP/block-design operations, and device programming, but most can be worked around via TCL.
Related MCP Connectors
Connect ChatGPT, Claude, Cursor or VS Code to your Windows PC: files, terminal, browser, apps.
Design circuits, simulate and verify embedded firmware, and lay out PCBs with AI agents.
- DNS-DATA RemoteDeprecatedcom.dns-data
Connect AI assistants to authorized Windows and macOS devices for files, commands, and management.
Use your Mac, Windows or Linux computer from ChatGPT, Claude or Codex: files, commands, documents.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI assistants to drive Xilinx Vivado, Intel Quartus, and Anlogic TangDynasty for FPGA development, including project creation, synthesis, implementation, timing closure, and hardware programming through natural language.42 PyPI6MIT
- FlicenseNot gradedqualityAmaintenanceEnables AI coding agents such as Claude Code, Cursor, and Codex to drive a locally installed Xilinx Vivado across the full FPGA flow, from GUI, headless Tcl, or attached sessions through synthesis, implementation, timing and CDC analysis, waveform queries, and device programming. It exposes 32 curated tools plus evidence-driven workflow prompts that return structured timing/IO reports, Chinese-language CRITICAL WARNING diagnostics, and guarded bitstream generation.-
- FlicenseNot gradedqualityAmaintenanceEnables AI coding agents such as Claude Code, Cursor, and Codex to drive a locally installed Xilinx Vivado across the full FPGA flow, with tools for sessions, synthesis, implementation, timing, CDC, XDC, IP, waveform querying, and device programming. It also provides structured timing evidence with baseline comparison, offline VCD analysis, evidence-driven workflow prompts, and a read-only doctor for environment self-checks.-
- FlicenseNot gradedqualityAmaintenanceEnables AI coding agents to safely drive a locally installed Xilinx Vivado FPGA flow, covering session control, synthesis, implementation, timing and CDC analysis, XDC constraints, IP inspection, waveform queries, and device programming with structured, evidence-based diagnostics.-