Project

General

Profile

Actions

Feature #869

closed
길문 상이

Feature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축

Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증

PoC-02 — Python FastMCP 서버 구축 및 기본 Tool 테스트

Feature #869: PoC-02 — Python FastMCP 서버 구축 및 기본 Tool 테스트

Added by 길래 문 23 days ago. Updated 20 days ago.

Status:
Closed
Priority:
High
Assignee:
Start date:
10/26/2026
Due date:
11/02/2026
% Done:

100%

Estimated time:

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. 제출 산출물

  1. Python FastMCP 서버 소스코드
  2. 기본 MCP Tool 2개
  3. 개발환경 및 의존성 명세
  4. MCP 서버 설치·실행 가이드
  5. Tool별 JSON 입력·출력 예시
  6. pytest 및 실제 MCP 호출 테스트 결과
  7. 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 상세 로드맵

https://github.com/GilbertMoon/icn-solar-cad-agent/blob/main/docs/autodesk-mcp-l2-l1-poc-roadmap-20261025.md

전체 업무계획서

https://github.com/GilbertMoon/icn-solar-cad-agent/blob/main/docs/autodesk-mcp-l2-l1-work-plan-20261025.md

업무분장 및 시스템 통합계획

https://github.com/GilbertMoon/icn-solar-cad-agent/blob/main/docs/autodesk-mcp-l2-l1-team-knowledge-integration-plan-20261025.md

8. 후속 개발 연계

다음 작업: PoC-03 — VSCode Copilot MCP 연결 및 자연어 Tool 호출 검증

PoC-02에서 완성된 로컬 MCP 서버를 VSCode Copilot Chat에 연결하고, AI가 기본 MCP Tool을 실제로 호출할 수 있는지 확인한다.

Actions

Also available in: PDF Atom