Vivado용 MCP

AI를 위한 Vivado MCP 워크벤치입니다.
본 프로젝트는 MCP-first 설계를 채택하였으며, 자체 데스크톱 GUI를 제공하지 않습니다. Vivado 관련 작업은 실제 Vivado GUI에서 수행해야 하며, 주요 단계에서는 해당 시각적 컨텍스트로 전환해야 합니다.

현재 상태

• 버전: v2.0.0

• PM 결론: v2 전체 완료

• 현재 릴리스 범위:

  • Windows 메인라인 사용 시나리오

  • v2 public workflow 메서드 측면

  • phase-2 핵심 도메인 간 폐루프

  • phase-3 proof / contract / semantic / referent / public schema 수렴 체인

적용 시나리오

• AI가 MCP / workflow 메서드를 호출하여 Vivado 설계, 검증 및 디버깅 메인 프로세스를 주도

• 로컬 Vivado 버전을 자동으로 검색하고 워크스페이스 수준의 바인딩 완료

• IP 설계, Block Design 설계, 시뮬레이션 실행

• 시뮬레이션 / 타이밍 / ILA / 설계 후속 조치 간의 자동 피드백 및 재검증

• Vivado GUI에서 주요 단계에 해당하는 컨텍스트 표시

디렉토리 설명

• docs/USER_INSTALL_AND_USAGE.md 사용자 설치 및 사용 설명서

• docs/AI_INSTALL_AND_USAGE.md AI / Agent를 위한 접속 설명서

• docs/AI_MCP_RELEASE_INSTALL.md AI / MCP 클라이언트를 위한 릴리스 설치 설명서

• scripts/install_mcp_for_ai.ps1 Windows 원클릭 설치 스크립트

• docs/mcp/V2_PUBLIC_API.md v2 public MCP 메서드 목록

• docs/pm/V2_FINAL_COMPLETION_MEMO.md v2 최종 수렴 메모

• docs/V2_RELEASE_PACKAGE.md v2 릴리스 패키지 설명 및 릴리스 목록

빠른 시작

1. Python 3.11+ 설치

2. Vivado 설치 (버전 2018.3 이상 권장)

3. 실행:

cd D:\ai_playgraund\vivado_mcp
powershell -ExecutionPolicy Bypass -File .\scripts\install_mcp_for_ai.ps1

4. docs/USER_INSTALL_AND_USAGE.md 또는 docs/AI_INSTALL_AND_USAGE.md를 참조하여 사용 시작

현재 진입점

현재 릴리스 버전은 Python 프로세스 내 MCP 스타일 진입점을 노출합니다:

• server.py

• v2_public_server.py

핵심 클래스:

• fpga_mcp.FpgaMcpServer

• fpga_mcp.FpgaMcpV2PublicServer

설명:

• 현재 저장소는 "메서드 등록 + 프로토콜 반환 셸 + 오케스트레이션 연결"의 Python 패키지 진입점을 제공합니다.

• 독립적인 stdio / HTTP 전송 계층 서비스가 아닙니다.

• 외부 AI 호스트