Feature #870
closedFeature #866: [MASTER] ICN Solar CAD Agent — Autodesk MCP 및 L2→L1 태양광 자동설계 시스템 구축
Feature #867: Phase 1 — MCP 기반 태양광 CAD 자동설계 플랫폼 구축 및 통합 검증
PoC-03. VSCode Copilot MCP 연결 및 자연어 Tool 호출 검증
100%
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_infoTool 인식 확인- Tool 실행 권한 요청 및 사용자 승인 절차 확인
STEP 4. 자연어 기반 Tool 호출 테스트¶
다음과 같은 자연어 명령으로 실제 Tool을 호출한다.
테스트 1 — MCP 서버 연결 확인
"연결된 Solar CAD MCP 서버의 상태를 확인해 줘."
예상 결과:
- Copilot이
pingTool 호출 - MCP 서버에서 정상 응답 반환
- Copilot Chat에서 실행 결과 확인
테스트 2 — 서버 정보 조회
"Solar CAD MCP 서버의 이름과 버전을 알려 줘."
예상 결과:
- Copilot이
get_server_infoTool 호출 - 서버 정보 반환
- 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. 제출 산출물¶
- VSCode Copilot MCP 연결 설정 및 가이드
- Python FastMCP 서버 연동 실행 예시
ping및get_server_info자연어 호출 결과- 오류·재연결 테스트 결과
- 테스트 로그 및 화면 Evidence
- 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 상세 로드맵
전체 업무계획서
업무분장 및 시스템 통합계획
8. 후속 개발 연계¶
다음 작업: PoC-04 — Source 파일 목록 조회·접근 권한 및 무결성 검증
PoC-03에서 검증한 MCP 연결 환경을 기반으로 향후 Source 조회, CAD 분석 및 Engineering Knowledge 기능을 Tool로 단계적으로 확장한다.