wehub-resource-sync🐙 모듈 4: 실전 MCP 개발 - 맞춤형 GitHub 클론 서버
⚡ 빠른 시작: 단 30분 만에 GitHub 리포지토리 클로닝과 VS Code 통합을 자동화하는 프로덕션 준비 완료 MCP 서버를 구축하세요!
🎯 학습 목표
이 실습을 완료하면 다음을 할 수 있습니다:
- ✅ 실제 개발 워크플로우용 맞춤형 MCP 서버 생성
- ✅ MCP를 통한 GitHub 리포지토리 클로닝 기능 구현
- ✅ 맞춤형 MCP 서버를 VS Code 및 Agent Builder와 통합
- ✅ GitHub Copilot Agent Mode를 맞춤형 MCP 도구와 함께 사용
- ✅ 맞춤형 MCP 서버를 프로덕션 환경에서 테스트하고 배포
📋 선행 조건
- 실습 1~3 완료 (MCP 기본 및 고급 개발)
- GitHub Copilot 구독 (무료 가입 가능)
- Microsoft Foundry Toolkit 및 GitHub Copilot 확장 기능이 설치된 VS Code
- 설치 및 구성된 Git CLI
🏗️ 프로젝트 개요
실제 개발 과제
개발자로서 우리는 GitHub에서 리포지토리를 클론 하고 VS Code 또는 VS Code Insiders에서 열기 위해 다음과 같은 수동 작업을 자주 수행합니다:
- 터미널 또는 명령 프롬프트 열기
- 원하는 디렉터리로 이동
git clone명령 실행- 클론된 디렉터리에서 VS Code 열기
우리의 MCP 솔루션은 이를 단일 지능형 명령으로 간소화합니다!
만들게 될 것
다음 기능을 제공하는 GitHub Clone MCP 서버 (git_mcp_server):
| 기능 | 설명 | 이점 |
|---|---|---|
| 🔄 스마트 리포지토리 클로닝 | 유효성 검사를 통한 GitHub 리포지토리 클론 | 자동 오류 검사 |
| 📁 지능형 디렉터리 관리 | 안전한 디렉터리 확인 및 생성 | 덮어쓰기 방지 |
| 🚀 크로스 플랫폼 VS Code 통합 | VS Code/Insiders에서 프로젝트 열기 | 원활한 워크플로우 전환 |
| 🛡️ 견고한 오류 처리 | 네트워크, 권한, 경로 문제 처리 | 프로덕션 준비 신뢰성 |
📖 단계별 구현
1단계: Agent Builder에서 GitHub 에이전트 생성
-
Microsoft Foundry Toolkit 확장을 통해 Agent Builder 실행
-
다음 구성으로 새 에이전트 생성:
Agent Name: GitHubAgent -
맞춤형 MCP 서버 초기화:
- 도구 → 도구 추가 → MCP 서버로 이동
- "새 MCP 서버 생성" 선택
- 최대한 유연한 Python 템플릿 선택
- 서버 이름:
git_mcp_server
2단계: GitHub Copilot Agent Mode 구성
- VS Code에서 GitHub Copilot 열기 (Ctrl/Cmd + Shift + P → "GitHub Copilot: Open")
- Copilot 인터페이스에서 Agent 모델 선택
- 향상된 추론 기능을 위해 Claude 3.7 모델 선택
- 도구 접근을 위해 MCP 통합 활성화
💡 전문가 팁: Claude 3.7은 개발 워크플로우와 오류 처리 패턴에 대한 뛰어난 이해를 제공합니다.
3단계: 핵심 MCP 서버 기능 구현
다음 세부 프롬프트를 GitHub Copilot Agent Mode와 함께 사용하세요:
Create two MCP tools with the following comprehensive requirements:
🔧 TOOL A: clone_repository
Requirements:
- Clone any GitHub repository to a specified local folder
- Return the absolute path of the successfully cloned project
- Implement comprehensive validation:
✓ Check if target directory already exists (return error if exists)
✓ Validate GitHub URL format (https://github.com/user/repo)
✓ Verify git command availability (prompt installation if missing)
✓ Handle network connectivity issues
✓ Provide clear error messages for all failure scenarios
🚀 TOOL B: open_in_vscode
Requirements:
- Open specified folder in VS Code or VS Code Insiders
- Cross-platform compatibility (Windows/Linux/macOS)
- Use direct application launch (not terminal commands)
- Auto-detect available VS Code installations
- Handle cases where VS Code is not installed
- Provide user-friendly error messages
Additional Requirements:
- Follow MCP 1.9.3 best practices
- Include proper type hints and documentation
- Implement logging for debugging purposes
- Add input validation for all parameters
- Include comprehensive error handling
4단계: MCP 서버 테스트
4a. Agent Builder 내 테스트
- Agent Builder에서 디버그 구성 실행
- 다음 시스템 프롬프트로 에이전트 구성:
SYSTEM_PROMPT:
You are my intelligent coding repository assistant. You help developers efficiently clone GitHub repositories and set up their development environment. Always provide clear feedback about operations and handle errors gracefully.
- 실제 사용자 시나리오로 테스트:
USER_PROMPT EXAMPLES:
Scenario : Basic Clone and Open
"Clone {Your GitHub Repo link such as https://github.com/kinfey/GHCAgentWorkshop
} and save to {The global path you specify}, then open it with VS Code Insiders"
예상 결과:
- ✅ 경로 확인과 함께 성공적인 클로닝
- ✅ 자동 VS Code 실행
- ✅ 잘못된 상황에 대한 명확한 오류 메시지
- ✅ 엣지 케이스 적절한 처리
4b. MCP Inspector 내 테스트
🎉 축하합니다! 실제 개발 워크플로우 문제를 해결하는 실용적이고 프로덕션 준비된 MCP 서버를 성공적으로 만들었습니다. 여러분의 맞춤형 GitHub 클론 서버는 개발자 생산성을 자동화하고 향상하는 MCP의 강력함을 보여줍니다.
🏆 업적 달성:
- ✅ MCP 개발자 - 맞춤형 MCP 서버 생성
- ✅ 워크플로우 자동화자 - 개발 프로세스 간소화
- ✅ 통합 전문가 - 다양한 개발 도구 연결
- ✅ 프로덕션 준비 완료 - 배포 가능한 솔루션 구축
🎓 워크샵 완료: Model Context Protocol과 함께한 여정
워크샵 참가자 여러분께,
Model Context Protocol 워크샵의 네 모듈 전부를 완료한 것을 축하합니다! Microsoft Foundry Toolkit의 기본 개념을 이해하는 단계에서부터 실제 개발 문제를 해결하는 프로덕션 준비 MCP 서버를 구축하는 단계까지 먼 길을 왔습니다.
🚀 학습 경로 요약:
모듈 1: Microsoft Foundry Toolkit 기본, 모델 테스트 및 첫 AI 에이전트 생성 시작
모듈 2: MCP 아키텍처 학습, Playwright MCP 통합, 첫 브라우저 자동화 에이전트 구축
모듈 3: Weather MCP 서버를 통한 맞춤형 MCP 서버 개발 심화, 디버깅 도구 숙련
모듈 4: 실용적인 GitHub 리포지토리 워크플로우 자동화 도구 적용
🌟 마스터한 내용:
- ✅ Microsoft Foundry Toolkit 생태계: 모델, 에이전트, 통합 패턴
- ✅ MCP 아키텍처: 클라이언트-서버 설계, 전송 프로토콜, 보안
- ✅ 개발 도구: Playground, Inspector, 프로덕션 배포
- ✅ 맞춤형 개발: MCP 서버 구축, 테스트, 배포
- ✅ 실전 응용: AI로 실제 워크플로우 문제 해결
🔮 앞으로의 단계:
- 나만의 MCP 서버 구축: 고유한 워크플로우 자동화에 이 기술 적용
- MCP 커뮤니티 참여: 창작물을 공유하고 배우기
- 고급 통합 탐색: MCP 서버를 엔터프라이즈 시스템에 연결
- 오픈 소스 기여: MCP 도구 및 문서 개선에 참여
이번 워크샵은 시작에 불과합니다. Model Context Protocol 생태계는 빠르게 진화 중이며, 여러분은 AI 기반 개발 도구의 최전선에 설 준비가 되어 있습니다.
참여해 주시고 배우는 데 헌신해 주셔서 감사합니다!
이번 워크샵이 여러분의 개발 여정에서 AI 도구를 구축하고 상호작용하는 방식을 변화시킬 아이디어를 불러일으키길 바랍니다.
행복한 코딩 되세요!
다음 단계
모듈 10의 모든 실습을 완료한 것을 축하합니다!
- 뒤로 가기: 모듈 10 개요
- 계속하기: 모듈 11: MCP 서버 실습
면책 조항: 이 문서는 AI 번역 서비스 Co-op Translator를 사용하여 번역되었습니다. 정확성을 기하기 위해 노력하고 있으나, 자동 번역은 오류나 부정확한 부분이 있을 수 있음을 유의하시기 바랍니다. 원본 문서의 원어본이 권위 있는 자료로 간주되어야 합니다. 중요한 정보의 경우, 전문가의 인간 번역을 권장합니다. 이 번역 사용으로 인해 발생하는 오해나 잘못된 해석에 대해 당사는 책임을 지지 않습니다.