wehub-resource-sync
213 lines
9.9 KiB
Markdown
213 lines
9.9 KiB
Markdown
# 🐙 Moduł 4: Praktyczny rozwój MCP - Własny serwer klonujący GitHub
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
> **⚡ Szybki start:** Zbuduj produkcyjny serwer MCP automatyzujący klonowanie repozytoriów GitHub i integrację z VS Code w zaledwie 30 minut!
|
|
|
|
## 🎯 Cele nauki
|
|
|
|
Pod koniec tego laboratorium będziesz potrafił:
|
|
|
|
- ✅ Utworzyć niestandardowy serwer MCP do rzeczywistych przepływów pracy programistycznej
|
|
- ✅ Zaimplementować funkcjonalność klonowania repozytoriów GitHub za pośrednictwem MCP
|
|
- ✅ Zintegrować własne serwery MCP z VS Code i Agent Builder
|
|
- ✅ Korzystać z trybu agenta GitHub Copilot z niestandardowymi narzędziami MCP
|
|
- ✅ Testować i wdrażać niestandardowe serwery MCP w środowiskach produkcyjnych
|
|
|
|
## 📋 Wymagania wstępne
|
|
|
|
- Ukończenie laboratoriów 1-3 (podstawy MCP i zaawansowany rozwój)
|
|
- Subskrypcja GitHub Copilot ([dostępna darmowa rejestracja](https://github.com/github-copilot/signup))
|
|
- VS Code z rozszerzeniami Microsoft Foundry Toolkit oraz GitHub Copilot
|
|
- Zainstalowany i skonfigurowany Git CLI
|
|
|
|
## 🏗️ Przegląd projektu
|
|
|
|
### **Rzeczywiste wyzwanie developerskie**
|
|
Jako programiści często korzystamy z GitHub, aby klonować repozytoria i otwierać je w VS Code lub VS Code Insiders. Ten ręczny proces polega na:
|
|
1. Otworzeniu terminala/powłoki poleceń
|
|
2. Nawigacji do wybranego katalogu
|
|
3. Uruchomieniu polecenia `git clone`
|
|
4. Otwarciu VS Code w sklonowanym katalogu
|
|
|
|
**Nasze rozwiązanie MCP upraszcza to do jednego inteligentnego polecenia!**
|
|
|
|
### **Co zbudujesz**
|
|
**GitHub Clone MCP Server** (`git_mcp_server`), który zapewnia:
|
|
|
|
| Funkcja | Opis | Korzyść |
|
|
|---------|-------------|---------|
|
|
| 🔄 **Inteligentne klonowanie repozytorium** | Klonowanie repozytoriów GitHub z walidacją | Zautomatyzowane sprawdzanie błędów |
|
|
| 📁 **Inteligentne zarządzanie katalogami** | Bezpieczna kontrola i tworzenie katalogów | Zapobiega nadpisywaniu |
|
|
| 🚀 **Wieloplatformowa integracja z VS Code** | Otwieranie projektów w VS Code/Insiders | Płynne przejście w przepływie pracy |
|
|
| 🛡️ **Solidna obsługa błędów** | Obsługa problemów z siecią, uprawnieniami i ścieżkami | Gotowość do produkcji |
|
|
|
|
---
|
|
|
|
## 📖 Realizacja krok po kroku
|
|
|
|
### Krok 1: Utwórz agenta GitHub w Agent Builder
|
|
|
|
1. **Uruchom Agent Builder** za pomocą rozszerzenia Microsoft Foundry Toolkit
|
|
2. **Utwórz nowego agenta** z następującą konfiguracją:
|
|
```
|
|
Agent Name: GitHubAgent
|
|
```
|
|
|
|
3. **Zainicjuj niestandardowy serwer MCP:**
|
|
- Przejdź do **Narzędzia** → **Dodaj narzędzie** → **Serwer MCP**
|
|
- Wybierz **„Utwórz nowy serwer MCP”**
|
|
- Wybierz szablon **Python** dla maksymalnej elastyczności
|
|
- **Nazwa serwera:** `git_mcp_server`
|
|
|
|
### Krok 2: Skonfiguruj tryb agenta GitHub Copilot
|
|
|
|
1. **Otwórz GitHub Copilot** w VS Code (Ctrl/Cmd + Shift + P → "GitHub Copilot: Open")
|
|
2. **Wybierz model agenta** w interfejsie Copilot
|
|
3. **Wybierz model Claude 3.7** dla lepszych zdolności rozumowania
|
|
4. **Włącz integrację MCP** dla dostępu do narzędzi
|
|
|
|
> **💡 Profesjonalna wskazówka:** Claude 3.7 zapewnia lepsze rozumienie przepływów pracy i wzorców obsługi błędów.
|
|
|
|
### Krok 3: Zaimplementuj podstawową funkcjonalność serwera MCP
|
|
|
|
**Użyj poniższego szczegółowego polecenia z trybem agenta 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
|
|
```
|
|
|
|
### Krok 4: Przetestuj swój serwer MCP
|
|
|
|
#### 4a. Test w Agent Builder
|
|
|
|
1. **Uruchom konfigurację debugowania** w Agent Builder
|
|
2. **Skonfiguruj swojego agenta z tym poleceniem systemowym:**
|
|
|
|
```
|
|
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. **Przetestuj na realistycznych scenariuszach użytkownika:**
|
|
|
|
```
|
|
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"
|
|
```
|
|
|
|
|
|
|
|
**Oczekiwane wyniki:**
|
|
- ✅ Pomyślne klonowanie z potwierdzeniem ścieżki
|
|
- ✅ Automatyczne uruchomienie VS Code
|
|
- ✅ Jasne komunikaty o błędach dla nieprawidłowych scenariuszy
|
|
- ✅ Poprawna obsługa nietypowych przypadków
|
|
|
|
#### 4b. Test w MCP Inspector
|
|
|
|
|
|
|
|
|
|
---
|
|
|
|
|
|
|
|
**🎉 Gratulacje!** Udało Ci się stworzyć praktyczny, produkcyjny serwer MCP, który rozwiązuje rzeczywiste wyzwania developerskie. Twój własny serwer do klonowania GitHub pokazuje moc MCP w automatyzacji i zwiększaniu produktywności programistów.
|
|
|
|
### 🏆 Odblokowane osiągnięcia:
|
|
- ✅ **Programista MCP** - Utworzono niestandardowy serwer MCP
|
|
- ✅ **Automator przepływów pracy** - Uproszczone procesy rozwojowe
|
|
- ✅ **Ekspert integracji** - Połączono wiele narzędzi developerskich
|
|
- ✅ **Gotowość produkcyjna** - Zbudowano rozwiązania gotowe do wdrożenia
|
|
|
|
---
|
|
|
|
## 🎓 Zakończenie warsztatów: Twoja podróż z Model Context Protocol
|
|
|
|
**Drogi Uczestniku Warsztatów,**
|
|
|
|
Gratulacje z okazji ukończenia wszystkich czterech modułów warsztatów Model Context Protocol! Przeszedłeś długą drogę, od poznania podstaw Microsoft Foundry Toolkit po budowę produkcyjnych serwerów MCP, które rozwiązują rzeczywiste wyzwania deweloperskie.
|
|
|
|
### 🚀 Podsumowanie ścieżki nauki:
|
|
|
|
**[Moduł 1](../lab1/README.md)**: Zacząłeś od poznawania podstaw Microsoft Foundry Toolkit, testowania modeli i tworzenia pierwszego agenta AI.
|
|
|
|
**[Moduł 2](../lab2/README.md)**: Poznałeś architekturę MCP, zintegrowałeś Playwright MCP i stworzyłeś pierwszego agenta do automatyzacji przeglądarki.
|
|
|
|
**[Moduł 3](../lab3/README.md)**: Przeszedłeś do zaawansowanego rozwoju niestandardowych serwerów MCP z Weather MCP i opanowałeś narzędzia debugowania.
|
|
|
|
**[Moduł 4](../lab4/README.md)**: Teraz zastosowałeś wszystko, tworząc praktyczne narzędzie automatyzujące przepływ pracy z repozytoriami GitHub.
|
|
|
|
### 🌟 Co opanowałeś:
|
|
|
|
- ✅ **Ekosystem Microsoft Foundry Toolkit**: Modele, agenci i wzorce integracji
|
|
- ✅ **Architektura MCP**: Projekt klient-serwer, protokoły transportowe i bezpieczeństwo
|
|
- ✅ **Narzędzia developerskie**: Od Playground do Inspector i wdrożeń produkcyjnych
|
|
- ✅ **Niestandardowy rozwój**: Tworzenie, testowanie i wdrażanie własnych serwerów MCP
|
|
- ✅ **Praktyczne zastosowania**: Rozwiązywanie rzeczywistych problemów workflow za pomocą AI
|
|
|
|
### 🔮 Twoje następne kroki:
|
|
|
|
1. **Zbuduj własny serwer MCP**: Wykorzystaj te umiejętności, aby zautomatyzować swoje unikalne procesy pracy
|
|
2. **Dołącz do społeczności MCP**: Dziel się swoimi projektami i ucz się od innych
|
|
3. **Eksploruj zaawansowaną integrację**: Połącz serwery MCP z systemami korporacyjnymi
|
|
4. **Wspieraj open source**: Pomóż ulepszać narzędzia i dokumentację MCP
|
|
|
|
Pamiętaj, że ten warsztat to dopiero początek. Ekosystem Model Context Protocol szybko się rozwija, a Ty masz teraz narzędzia, by być na czele rozwoju narzędzi programistycznych wspieranych AI.
|
|
|
|
**Dziękujemy za udział i zaangażowanie w naukę!**
|
|
|
|
Mamy nadzieję, że ten warsztat zainspirował Cię do nowych pomysłów, które zmienią sposób budowania i wykorzystywania narzędzi AI w Twojej pracy programistycznej.
|
|
|
|
**Szczęśliwego kodowania!**
|
|
|
|
---
|
|
|
|
## Co dalej
|
|
|
|
Gratulacje z ukończenia wszystkich laboratoriów w Module 10!
|
|
|
|
- Wróć do: [Przegląd Modułu 10](../README.md)
|
|
- Kontynuuj do: [Moduł 11: Laboratoria MCP Server Hands-On](../../11-MCPServerHandsOnLabs/README.md)
|
|
|
|
---
|
|
|
|
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
|
|
**Zastrzeżenie**:
|
|
Niniejszy dokument został przetłumaczony za pomocą usługi tłumaczenia AI [Co-op Translator](https://github.com/Azure/co-op-translator). Choć dążymy do dokładności, prosimy pamiętać, że automatyczne tłumaczenia mogą zawierać błędy lub niedokładności. Oryginalny dokument w jego języku źródłowym należy uznawać za autorytatywne źródło. W przypadku informacji krytycznych zalecane jest skorzystanie z profesjonalnego tłumaczenia wykonanego przez człowieka. Nie ponosimy odpowiedzialności za jakiekolwiek nieporozumienia lub błędne interpretacje wynikające z użycia tego tłumaczenia.
|
|
<!-- CO-OP TRANSLATOR DISCLAIMER END --> |