wehub-resource-sync
212 lines
9.4 KiB
Markdown
212 lines
9.4 KiB
Markdown
# 🐙 모듈 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 구독 ([무료 가입 가능](https://github.com/github-copilot/signup))
|
|
- Microsoft Foundry Toolkit 및 GitHub Copilot 확장 기능이 설치된 VS Code
|
|
- 설치 및 구성된 Git CLI
|
|
|
|
## 🏗️ 프로젝트 개요
|
|
|
|
### **실제 개발 과제**
|
|
개발자로서 우리는 GitHub에서 리포지토리를 클론 하고 VS Code 또는 VS Code Insiders에서 열기 위해 다음과 같은 수동 작업을 자주 수행합니다:
|
|
1. 터미널 또는 명령 프롬프트 열기
|
|
2. 원하는 디렉터리로 이동
|
|
3. `git clone` 명령 실행
|
|
4. 클론된 디렉터리에서 VS Code 열기
|
|
|
|
**우리의 MCP 솔루션은 이를 단일 지능형 명령으로 간소화합니다!**
|
|
|
|
### **만들게 될 것**
|
|
다음 기능을 제공하는 **GitHub Clone MCP 서버** (`git_mcp_server`):
|
|
|
|
| 기능 | 설명 | 이점 |
|
|
|---------|-------------|---------|
|
|
| 🔄 **스마트 리포지토리 클로닝** | 유효성 검사를 통한 GitHub 리포지토리 클론 | 자동 오류 검사 |
|
|
| 📁 **지능형 디렉터리 관리** | 안전한 디렉터리 확인 및 생성 | 덮어쓰기 방지 |
|
|
| 🚀 **크로스 플랫폼 VS Code 통합** | VS Code/Insiders에서 프로젝트 열기 | 원활한 워크플로우 전환 |
|
|
| 🛡️ **견고한 오류 처리** | 네트워크, 권한, 경로 문제 처리 | 프로덕션 준비 신뢰성 |
|
|
|
|
---
|
|
|
|
## 📖 단계별 구현
|
|
|
|
### 1단계: Agent Builder에서 GitHub 에이전트 생성
|
|
|
|
1. Microsoft Foundry Toolkit 확장을 통해 **Agent Builder 실행**
|
|
2. 다음 구성으로 **새 에이전트 생성:**
|
|
```
|
|
Agent Name: GitHubAgent
|
|
```
|
|
|
|
3. **맞춤형 MCP 서버 초기화:**
|
|
- <strong>도구</strong> → **도구 추가** → <strong>MCP 서버</strong>로 이동
|
|
- **"새 MCP 서버 생성"** 선택
|
|
- 최대한 유연한 **Python 템플릿 선택**
|
|
- **서버 이름:** `git_mcp_server`
|
|
|
|
### 2단계: GitHub Copilot Agent Mode 구성
|
|
|
|
1. VS Code에서 **GitHub Copilot 열기** (Ctrl/Cmd + Shift + P → "GitHub Copilot: Open")
|
|
2. Copilot 인터페이스에서 **Agent 모델 선택**
|
|
3. 향상된 추론 기능을 위해 **Claude 3.7 모델 선택**
|
|
4. 도구 접근을 위해 **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 내 테스트
|
|
|
|
1. Agent Builder에서 **디버그 구성 실행**
|
|
2. 다음 시스템 프롬프트로 에이전트 구성:
|
|
|
|
```
|
|
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.
|
|
```
|
|
|
|
3. 실제 사용자 시나리오로 테스트:
|
|
|
|
```
|
|
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](../lab1/README.md)**: Microsoft Foundry Toolkit 기본, 모델 테스트 및 첫 AI 에이전트 생성 시작
|
|
|
|
**[모듈 2](../lab2/README.md)**: MCP 아키텍처 학습, Playwright MCP 통합, 첫 브라우저 자동화 에이전트 구축
|
|
|
|
**[모듈 3](../lab3/README.md)**: Weather MCP 서버를 통한 맞춤형 MCP 서버 개발 심화, 디버깅 도구 숙련
|
|
|
|
**[모듈 4](../lab4/README.md)**: 실용적인 GitHub 리포지토리 워크플로우 자동화 도구 적용
|
|
|
|
### 🌟 마스터한 내용:
|
|
|
|
- ✅ **Microsoft Foundry Toolkit 생태계**: 모델, 에이전트, 통합 패턴
|
|
- ✅ **MCP 아키텍처**: 클라이언트-서버 설계, 전송 프로토콜, 보안
|
|
- ✅ **개발 도구**: Playground, Inspector, 프로덕션 배포
|
|
- ✅ **맞춤형 개발**: MCP 서버 구축, 테스트, 배포
|
|
- ✅ **실전 응용**: AI로 실제 워크플로우 문제 해결
|
|
|
|
### 🔮 앞으로의 단계:
|
|
|
|
1. **나만의 MCP 서버 구축**: 고유한 워크플로우 자동화에 이 기술 적용
|
|
2. **MCP 커뮤니티 참여**: 창작물을 공유하고 배우기
|
|
3. **고급 통합 탐색**: MCP 서버를 엔터프라이즈 시스템에 연결
|
|
4. **오픈 소스 기여**: MCP 도구 및 문서 개선에 참여
|
|
|
|
이번 워크샵은 시작에 불과합니다. Model Context Protocol 생태계는 빠르게 진화 중이며, 여러분은 AI 기반 개발 도구의 최전선에 설 준비가 되어 있습니다.
|
|
|
|
**참여해 주시고 배우는 데 헌신해 주셔서 감사합니다!**
|
|
|
|
이번 워크샵이 여러분의 개발 여정에서 AI 도구를 구축하고 상호작용하는 방식을 변화시킬 아이디어를 불러일으키길 바랍니다.
|
|
|
|
**행복한 코딩 되세요!**
|
|
|
|
---
|
|
|
|
## 다음 단계
|
|
|
|
모듈 10의 모든 실습을 완료한 것을 축하합니다!
|
|
|
|
- 뒤로 가기: [모듈 10 개요](../README.md)
|
|
- 계속하기: [모듈 11: MCP 서버 실습](../../11-MCPServerHandsOnLabs/README.md)
|
|
|
|
---
|
|
|
|
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
|
|
**면책 조항**:
|
|
이 문서는 AI 번역 서비스 [Co-op Translator](https://github.com/Azure/co-op-translator)를 사용하여 번역되었습니다. 정확성을 기하기 위해 노력하고 있으나, 자동 번역은 오류나 부정확한 부분이 있을 수 있음을 유의하시기 바랍니다. 원본 문서의 원어본이 권위 있는 자료로 간주되어야 합니다. 중요한 정보의 경우, 전문가의 인간 번역을 권장합니다. 이 번역 사용으로 인해 발생하는 오해나 잘못된 해석에 대해 당사는 책임을 지지 않습니다.
|
|
<!-- CO-OP TRANSLATOR DISCLAIMER END --> |