Feature #869
closedFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
PoC-02 — Python FastMCP 서버 구축 및 기본 Tool 테스트
100%
Description
PoC-02. Python FastMCP 서버 구축 및 기본 Tool 테스트¶
1. 작업 개요¶
본 PoC는 ICN Solar CAD Agent 프로젝트의 기반이 되는 Python FastMCP 서버를 구축하고 AI 클라이언트와 통신 가능한 기본 MCP Tool을 검증하는 작업이다.
앞선 PoC-01에서 조사한 기존 개발 자산을 우선 재사용하며, 아직 구현되지 않은 기능만 추가한다.
향후 VSCode Copilot, CAD 분석 도구, Engineering Knowledge Agent 및 L1 태양광 자동설계 엔진을 연결할 공통 인터페이스를 구축하는 것이 목표이다.
GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/143
상위 Redmine 일감: #867
담당: 이상재
PM 및 검토: 문길래
협력: 황수아, 조영우
계획 기간: 2026-10-26 ~ 2026-11-02
2. 세부 작업¶
STEP 1. 기존 코드 및 개발환경 확인¶
- PoC-01의 기존 자산 조사 결과 확인
- 기존 MCP 서버 및 유사 기능 존재 여부 점검
- Python 버전, 가상환경 및 의존성 확인
- 기존 프로젝트 구조와 충돌하지 않는 구현 경로 결정
- FastMCP 라이브러리 설치 및 실행환경 구성
STEP 2. FastMCP 기본 서버 구축¶
- Python 기반 로컬 MCP 서버 구성
- MCP 서버 실행 진입점 구현
- 표준 입출력(stdio) 기반 통신 구성
- 서버 초기화 및 정상 종료 처리
- 기본 예외 및 오류 처리 구현
STEP 3. 기본 MCP Tool 개발¶
다음 두 가지 기본 도구를 구현한다.
① ping
- MCP 서버 정상 연결 확인
- 간단한 입력에 대한 응답 반환
- 서버 통신 상태 검증
② get_server_info
- MCP 서버 이름·버전 조회
- 지원하는 기본 기능 정보 확인
- 후속 Tool 연동을 위한 기본 계약 제공
현재 PoC에서는 고객 CAD 파일을 처리하지 않으며, 해당 기능은 후속 PoC에서 추가한다.
STEP 4. MCP 통신 및 호출 테스트¶
- MCP 클라이언트 또는 Inspector로 서버 연결
- MCP 초기화 동작 확인
- Tool 목록 조회 테스트
- ping Tool 실제 호출 테스트
- get_server_info Tool 호출 테스트
- 정상 입력 및 비정상 입력 처리 확인
- 서버 종료·재시작 후 재연결 확인
STEP 5. 자동 테스트 및 코드 검증¶
- pytest 기반 최소 단위 테스트 작성
- MCP Tool 입출력 스키마 검증
- 예외 상황 및 오류 메시지 확인
- 서버 실행 중 프로토콜 출력 오염 여부 확인
- 기존 기능에 영향을 주지 않는지 최소 회귀 테스트 실행
STEP 6. 실행 가이드 및 GitHub 반영¶
- Windows PowerShell 기준 설치·실행 방법 문서화
- VSCode 환경에서 서버 실행 방법 정리
- Tool별 입력·출력 예시 작성
- 실제 실행 및 테스트 결과 Evidence 기록
- GitHub 작업 브랜치 및 PR 생성
- PM 검토 후 main 병합
3. 업무분장¶
| 담당자 | 역할 |
|---|---|
| 이상재 | FastMCP 서버 구축, 기본 Tool 개발, 실행 및 테스트 |
| 문길래 | 아키텍처·범위·완료 기준 검토, GitHub PR 승인 |
| 황수아 | 향후 Source 및 Knowledge Tool 연결을 위한 요구사항 검토 |
| 조영우 | 후속 L1 설계 Tool 입출력 계약 검토 |
4. 제출 산출물¶
- Python FastMCP 서버 소스코드
- 기본 MCP Tool 2개
- 개발환경 및 의존성 명세
- MCP 서버 설치·실행 가이드
- Tool별 JSON 입력·출력 예시
- pytest 및 실제 MCP 호출 테스트 결과
- GitHub PR 및 실행 Evidence
5. 완료 기준 (PASS)¶
- 기존 구현 조사 및 재사용 여부 확인
- Python FastMCP 서버 정상 실행
- MCP 클라이언트 연결 및 초기화 성공
- Tool 목록 정상 조회
- ping Tool 실제 호출 성공
- get_server_info Tool 실제 호출 성공
- 비정상 입력 및 오류 처리 테스트 PASS
- 서버 종료·재시작 동작 확인
- 테스트 코드 및 실행 Evidence 작성
- Windows/VSCode 환경 실행 방법 문서화
- GitHub PR 생성 및 PM 검토 완료
- main 병합 및 PoC-03 연동 준비 완료
6. 개발 및 보안 원칙¶
- 이미 구현된 기능이 있다면 신규 개발보다 재사용을 우선한다.
- 이번 단계에서는 로컬 MCP 통신 기능만 구축한다.
- 고객 DWG/DXF 파일은 수정하거나 외부로 전송하지 않는다.
- Autodesk APS 및 유료 API는 사용하지 않는다.
- 테스트 성공은 실제 실행 결과를 근거로 판단한다.
- 개발 결과가 후속 PoC에서도 재사용 가능하도록 Tool 계약을 명확히 한다.
7. GitHub 관련 문서¶
GitHub Issue
https://github.com/GilbertMoon/icn-solar-cad-agent/issues/143
25개 PoC 상세 로드맵
전체 업무계획서
업무분장 및 시스템 통합계획
8. 후속 개발 연계¶
다음 작업: PoC-03 — VSCode Copilot MCP 연결 및 자연어 Tool 호출 검증
PoC-02에서 완성된 로컬 MCP 서버를 VSCode Copilot Chat에 연결하고, AI가 기본 MCP Tool을 실제로 호출할 수 있는지 확인한다.