⚡ 빠른 시작: 30분 만에 GitHub 저장소 클로닝과 VS Code 통합을 자동화하는 생산 준비 완료 MCP 서버를 구축하세요!
이 실습을 완료하면 다음을 할 수 있습니다:
- ✅ 실제 개발 워크플로우에 맞는 맞춤형 MCP 서버 생성
- ✅ MCP를 통한 GitHub 저장소 클로닝 기능 구현
- ✅ 맞춤형 MCP 서버를 VS Code 및 Agent Builder와 통합
- ✅ GitHub Copilot 에이전트 모드를 맞춤 MCP 도구와 함께 사용
- ✅ 생산 환경에서 맞춤 MCP 서버를 테스트하고 배포
- 실습 1~3 완료 (MCP 기초 및 고급 개발)
- GitHub Copilot 구독 (무료 가입 가능)
- AI 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에서 열기 | 원활한 워크플로우 전환 |
| 🛡️ 견고한 오류 처리 | 네트워크, 권한, 경로 문제 처리 | 생산 환경용 신뢰성 |
-
AI Toolkit 확장에서 Agent Builder 실행
-
다음 설정으로 새 에이전트 생성:
Agent Name: GitHubAgent -
맞춤 MCP 서버 초기화:
- 도구 → 도구 추가 → MCP 서버 로 이동
- "새 MCP 서버 생성" 선택
- 최대 유연성을 위한 Python 템플릿 선택
- 서버 이름:
git_mcp_server
- VS Code에서 GitHub Copilot 실행 (Ctrl/Cmd + Shift + P → "GitHub Copilot: Open")
- Copilot 인터페이스에서 에이전트 모델 선택
- 향상된 추론 능력을 위해 Claude 3.7 모델 선택
- 도구 접근용 MCP 통합 활성화
💡 전문가 팁: Claude 3.7은 개발 워크플로우와 오류 처리 패턴에 대한 이해도가 뛰어납니다.
GitHub Copilot 에이전트 모드와 함께 다음 상세 프롬프트 사용:
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
- 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 실행
- ✅ 잘못된 시나리오에 대한 명확한 오류 메시지
- ✅ 경계 사례에 대한 적절한 처리
🎉 축하합니다! 실제 개발 워크플로우 문제를 해결하는 실용적이고 생산 준비 완료된 MCP 서버를 성공적으로 만들었습니다. 맞춤 GitHub 클론 서버는 개발자 생산성을 자동화하고 향상시키기 위한 MCP의 강력함을 보여줍니다.
- ✅ MCP 개발자 - 맞춤 MCP 서버 생성
- ✅ 워크플로우 자동화 전문가 - 개발 프로세스 간소화
- ✅ 통합 전문가 - 다양한 개발 도구 연결
- ✅ 생산 준비 완료 - 배포 가능한 솔루션 구축
워크숍 참가자 여러분,
Model Context Protocol 워크숍의 네 개 모듈 모두를 완료하신 것을 축하드립니다! 기본 AI Toolkit 개념 이해부터 실제 개발 문제를 해결하는 생산 준비 완료 MCP 서버 구축까지 긴 여정을 걸어오셨습니다.
모듈 1: AI Toolkit 기초, 모델 테스트, 첫 번째 AI 에이전트 생성 탐색
모듈 2: MCP 아키텍처 학습, Playwright MCP 통합, 첫 브라우저 자동화 에이전트 구축
모듈 3: Weather MCP 서버와 디버깅 도구를 통한 맞춤 MCP 서버 개발 고급 과정
모듈 4: 실용적인 GitHub 저장소 워크플로우 자동화 도구를 제작 적용
- ✅ AI Toolkit 생태계: 모델, 에이전트, 통합 패턴
- ✅ MCP 아키텍처: 클라이언트-서버 디자인, 전송 프로토콜, 보안
- ✅ 개발자 도구: Playground, Inspector, 생산 배포까지
- ✅ 맞춤 개발: 직접 MCP 서버 구축, 테스트 및 배포
- ✅ 실무 적용: AI로 실제 워크플로우 문제 해결
- 자신만의 MCP 서버 구축: 고유한 워크플로우 자동화에 이 기술 활용
- MCP 커뮤니티 참여: 창작물 공유 및 배우기
- 고급 통합 탐험: MCP 서버를 엔터프라이즈 시스템과 연결
- 오픈 소스 기여: MCP 도구와 문서 개선에 기여
이 워크숍은 시작에 불과합니다. Model Context Protocol 생태계는 빠르게 진화 중이며, 여러분은 AI 기반 개발 도구 선두에 설 준비가 되어 있습니다.
참여와 학습에 감사드립니다!
이 워크숍이 여러분의 개발 여정에서 AI 도구를 구축하고 활용하는 방식을 혁신하는 아이디어의 불씨가 되길 바랍니다.
즐거운 코딩 되세요!
모듈 10 관련 모든 실습을 완료하신 것을 축하드립니다!
- 뒤로 가기: 모듈 10 개요
- 계속 진행: 모듈 11: MCP 서버 실습
면책 조항:
이 문서는 AI 번역 서비스 Co-op Translator를 사용하여 번역되었습니다. 저희는 정확성을 위해 최선을 다하고 있으나, 자동 번역 결과에는 오류나 부정확한 부분이 있을 수 있음을 양해해 주시기 바랍니다. 원문은 해당 언어로 작성된 원본 문서가 권위 있는 자료로 간주되어야 합니다. 중요한 정보에 대해서는 전문적인 인간 번역을 권장합니다. 본 번역 사용으로 인해 발생하는 오해나 잘못된 해석에 대해 저희는 책임을 지지 않습니다.