Project

General

Profile

Actions

Feature #870

closed
길문 상이

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

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

PoC-03. VSCode Copilot MCP 연결 및 자연어 Tool 호출 검증

Feature #870: PoC-03. VSCode Copilot MCP 연결 및 자연어 Tool 호출 검증

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

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

100%

Estimated time:

Description

PoC-03. VSCode Copilot MCP 연결 및 자연어 Tool 호출 검증

1. 작업 개요

본 PoC는 PoC-02에서 구축한 Python FastMCP 서버를 VSCode GitHub Copilot Chat에 연결하여, 자연어 명령으로 MCP Tool을 실제 호출할 수 있는지 검증하는 작업이다.

최종적으로 AI 개발환경에서 CAD 분석 및 설계 자동화 도구를 자연어로 실행할 수 있는 공통 연결 기반을 확보한다.

GitHub Issue: https://github.com/GilbertMoon/icn-solar-cad-agent/issues/144

상위 Redmine 일감: #867

담당: 이상재

PM 및 검토: 문길래

협력: 황수아, 조영우

계획 기간: 2026-11-02 ~ 2026-11-06

선행 작업: PoC-02의 FastMCP 서버 및 기본 Tool 실행 검증

2. 세부 작업

STEP 1. VSCode 및 Copilot 개발환경 확인

  • VSCode 및 GitHub Copilot Chat 설치·버전 확인
  • Copilot에서 MCP 서버를 연결할 수 있는 환경인지 확인
  • 기존 MCP 설정 파일 및 설정 방식 조사
  • PoC-02의 FastMCP 서버 실행 명령과 경로 확인
  • Windows PowerShell 및 Python 가상환경 연동 확인

STEP 2. MCP 서버 연결 설정

  • VSCode에서 로컬 FastMCP 서버 등록
  • stdio 방식의 MCP 서버 실행 구성
  • Python 가상환경의 실행 경로 지정
  • 서버 실행에 필요한 작업 디렉터리 및 환경변수 설정
  • 설정 파일의 재사용성 및 보안 검토

개인 PC의 절대경로와 API 키 등 비밀정보는 저장소에 포함하지 않는다.

STEP 3. Copilot Chat에서 MCP Tool 인식 확인

  • Copilot Chat에서 연결된 MCP 서버 확인
  • 사용 가능한 Tool 목록 조회
  • ping 및 get_server_info Tool 인식 확인
  • Tool 실행 권한 요청 및 사용자 승인 절차 확인

STEP 4. 자연어 기반 Tool 호출 테스트

다음과 같은 자연어 명령으로 실제 Tool을 호출한다.

테스트 1 — MCP 서버 연결 확인

"연결된 Solar CAD MCP 서버의 상태를 확인해 줘."

예상 결과:

  • Copilot이 ping Tool 호출
  • MCP 서버에서 정상 응답 반환
  • Copilot Chat에서 실행 결과 확인

테스트 2 — 서버 정보 조회

"Solar CAD MCP 서버의 이름과 버전을 알려 줘."

예상 결과:

  • Copilot이 get_server_info Tool 호출
  • 서버 정보 반환
  • Copilot Chat에서 결과 표시

테스트 3 — 오류 및 예외 처리

  • MCP 서버 미실행 상태에서 연결 시도
  • 잘못된 실행 경로 설정
  • 지원하지 않는 Tool 호출
  • 잘못된 인수 전달
  • 서버 재시작 후 재연결

각 테스트의 실제 호출 여부와 결과를 기록한다.

STEP 5. 안정성 및 보안 검증

  • MCP 서버 연결 실패 시 오류 메시지 확인
  • 서버 실행 로그 확인
  • 서버 재시작 및 재연결 테스트
  • 비밀정보 및 사용자 로컬 경로 노출 여부 점검
  • 사용자가 승인하지 않은 파일 접근·외부 API 호출이 발생하지 않는지 확인
  • 기존 개발환경 및 프로젝트 코드에 영향을 주지 않는지 확인

STEP 6. 실행 가이드 및 GitHub 반영

  • Windows/VSCode 기준 MCP 연결 가이드 작성
  • 설정 파일 예시 및 실행 명령 문서화
  • 자연어 Tool 호출 예시 작성
  • 테스트 결과와 실제 실행 Evidence 기록
  • GitHub 작업 브랜치 및 PR 생성
  • PM 검토 후 main 병합

3. 업무분장

담당자 역할
이상재 MCP 연결 설정, Copilot Tool 호출 테스트, 오류 처리 검증
문길래 PoC 범위 및 검증 기준 확인, GitHub PR 최종 검토
황수아 후속 L2 Source 및 Knowledge Tool 연결 요구사항 검토
조영우 후속 L1 설계 Tool 연동 요구사항 검토

4. 제출 산출물

  1. VSCode Copilot MCP 연결 설정 및 가이드
  2. Python FastMCP 서버 연동 실행 예시
  3. ping 및 get_server_info 자연어 호출 결과
  4. 오류·재연결 테스트 결과
  5. 테스트 로그 및 화면 Evidence
  6. GitHub PR 및 검증 보고서

5. 완료 기준 (PASS)

  • VSCode Copilot MCP 서버 등록 및 연결 성공
  • Copilot Chat에서 MCP Tool 목록 확인
  • 자연어 명령으로 ping 실제 호출 성공
  • 자연어 명령으로 get_server_info 실제 호출 성공
  • 반환된 Tool 결과가 Copilot Chat에 정상 표시
  • 서버 연결 오류 및 재연결 테스트 PASS
  • 비정상 Tool 호출에 대한 오류 처리 검증
  • 보안정보 및 고객 설계자료 노출 없음
  • Windows/VSCode 실행 가이드 작성
  • 테스트 Evidence 및 GitHub PR 제출
  • PM 검토 및 main 병합 완료

6. 개발 및 검증 원칙

  • 기존 PoC-02 서버와 Tool을 재사용한다.
  • 단순 설정 화면 확인만으로 Tool 연동 성공을 판정하지 않는다.
  • 실제 Copilot Chat에서 Tool이 호출된 증빙을 확보한다.
  • 고객 DWG/DXF 파일의 읽기·수정은 이번 범위에서 제외한다.
  • Autodesk APS 및 유료 API는 호출하지 않는다.
  • Mock 결과와 실제 MCP 실행 결과를 명확히 구분한다.

7. GitHub 관련 문서

GitHub Issue

https://github.com/GilbertMoon/icn-solar-cad-agent/issues/144

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-04 — Source 파일 목록 조회·접근 권한 및 무결성 검증

PoC-03에서 검증한 MCP 연결 환경을 기반으로 향후 Source 조회, CAD 분석 및 Engineering Knowledge 기능을 Tool로 단계적으로 확장한다.

상이 Updated by 상재 이 22 days ago Actions #1

  • % Done changed from 0 to 10

상이 Updated by 상재 이 22 days ago Actions #2

  • % Done changed from 10 to 90

상이 Updated by 상재 이 22 days ago · Edited Actions #3

  • % Done changed from 90 to 100

상이 Updated by 상재 이 22 days ago · Edited Actions #4

PoC-03 완료 (PM 승인, 2026-10-27)

  • PR #182 병합 (main cdf1721). Codex 독립 리뷰 3차 APPROVE
  • 결과: pytest 61/61. PASS T01–T04, T06, T07, T09, T10a, S01, S02 / T05 OBSERVED
  • T08(서버 중지)·T10b(명시적 재시작): NOT_VERIFIED / OUT_OF_SCOPE_BY_PM
    • 사유: VS Code Copilot Agent Host가 MCP 서버를 세션마다 직접 실행하므로 중지·재시작을 제어하거나 관찰할 수 없음. PASS로 집계하지 않음
    • PoC-02 C06/C07은 Copilot 생명주기 검증 근거로 쓰지 않음
  • 보안: PoC-05부터 고객 CAD·Source 자료를 개인 Copilot Free로 보내지 않음. 합성 데이터만 사용
  • 후속 PR #184 (README에 PM 결정 기록): 병합 완료

상이 Updated by 상재 이 20 days ago Actions #5

  • Status changed from New to Closed
Actions

Also available in: PDF Atom