wehub-resource-sync🐙 Modul 4: Praktični razvoj MCP - lastni strežnik za kloniranje GitHub
⚡ Hiter začetek: Zgradite proizvodni MCP strežnik, ki avtomatizira kloniranje GitHub repozitorijev in integracijo z VS Code v samo 30 minutah!
🎯 Cilji učenja
Do konca te delavnice boste znali:
- ✅ Ustvariti lasten MCP strežnik za razvojne delovne tokove v realnem svetu
- ✅ Implementirati funkcijo kloniranja GitHub repozitorijev preko MCP
- ✅ Integrirati lastne MCP strežnike z VS Code in Agent Builderjem
- ✅ Uporabljati GitHub Copilot Agent Mode z lastnimi MCP orodji
- ✅ Testirati in uvajati lastne MCP strežnike v produkcijskih okoljih
📋 Predpogoji
- Zaključek laboratorijev 1-3 (osnove MCP in napredni razvoj)
- Naročnina na GitHub Copilot (na voljo brezplačna registracija)
- VS Code z Microsoft Foundry Toolkit in razširitvami GitHub Copilot
- Nameščen in konfiguriran Git CLI
🏗️ Pregled projekta
Razvojni izziv iz resničnega sveta
Kot razvijalci pogosto uporabljamo GitHub za kloniranje repozitorijev in njihovo odpiranje v VS Code ali VS Code Insiders. Ta ročni postopek vključuje:
- Odpiranje terminala/ukazne vrstice
- Premik v želeni imenik
- Izvajanje ukaza
git clone - Odpiranje VS Code v kloniranem imeniku
Naša MCP rešitev to poenostavi v eno pametno ukazno vrstico!
Kaj boste zgradili
GitHub Clone MCP strežnik (git_mcp_server), ki ponuja:
| Funkcija | Opis | Prednost |
|---|---|---|
| 🔄 Pametno kloniranje repozitorijev | Klonira GitHub repozitorije z validacijo | Avtomatsko preverjanje napak |
| 📁 Pametno upravljanje imenikov | Pregleda in varno ustvari imenike | Preprečuje prepisovanje |
| 🚀 Medplatformna integracija z VS Code | Odpre projekte v VS Code/Insiders | Gladek prehod delovnih tokov |
| 🛡️ Robustno upravljanje napak | Obvladuje omrežne, dovolilne in poti težave | Zanesljivost primerna za produkcijo |
📖 Korak za korakom implementacija
Korak 1: Ustvarite GitHub agenta v Agent Builderju
-
Zaženite Agent Builder preko razširitve Microsoft Foundry Toolkit
-
Ustvarite novega agenta z naslednjo konfiguracijo:
Agent Name: GitHubAgent -
Inicializirajte lasten MCP strežnik:
- Pojdite na Orodja → Dodaj orodje → MCP strežnik
- Izberite "Ustvari nov MCP strežnik"
- Izberite Python predlogo za največjo prilagodljivost
- Ime strežnika:
git_mcp_server
Korak 2: Konfigurirajte GitHub Copilot Agent Mode
- Odprite GitHub Copilot v VS Code (Ctrl/Cmd + Shift + P → "GitHub Copilot: Open")
- Izberite model agenta v vmesniku Copilot
- Izberite model Claude 3.7 za izboljšane zmožnosti razmišljanja
- Omogočite MCP integracijo za dostop do orodij
💡 Nasvet strokovnjaka: Claude 3.7 omogoča boljše razumevanje razvojnih tokov in vzorcev upravljanja napak.
Korak 3: Implementirajte osnovno funkcionalnost MCP strežnika
Uporabite naslednje podrobno navodilo z 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
Korak 4: Testirajte vaš MCP strežnik
4a. Testiranje v Agent Builderju
- Zaženite debug konfiguracijo za Agent Builder
- Konfigurirajte vašega agenta s tem sistemskim navodilom:
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.
- Testirajte z realističnimi uporabniškimi scenariji:
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"
Pričakovani rezultati:
- ✅ Uspešno kloniranje z potrdilom poti
- ✅ Samodejni zagon VS Code
- ✅ Jasna sporočila o napakah za neveljavne scenarije
- ✅ Pravilno upravljanje robnih primerov
4b. Testiranje v MCP Inspector
🎉 Čestitamo! Uspešno ste ustvarili praktični, proizvodni MCP strežnik, ki rešuje prave izzive razvojnih delovnih tokov. Vaš lastni strežnik za kloniranje GitHub ponazarja moč MCP za avtomatizacijo in povečanje produktivnosti razvijalcev.
🏆 Dosežki:
- ✅ Razvijalec MCP - Ustvaril lasten MCP strežnik
- ✅ Avtomatizator delovnih tokov - Poenostavil razvojne procese
- ✅ Strokovnjak za integracijo - Povezal več razvojnih orodij
- ✅ Pripravljen za produkcijo - Zgradil rešitve za uvedbo
🎓 Zaključek delavnice: Vaša pot z Model Context Protocol
Spoštovani udeleženec delavnice,
Čestitamo za zaključek vseh štirih modulov delavnice Model Context Protocol! Prepotovali ste dolgo pot od razumevanja osnov Microsoft Foundry Toolkit do izdelave proizvodnih MCP strežnikov, ki rešujejo prave razvojne izzive.
🚀 Povzetek vaše poti učenja:
Modul 1: Začeli ste z raziskovanjem osnov Microsoft Foundry Toolkit, testiranjem modelov in ustvarjanjem prvega AI agenta.
Modul 2: Naučili ste se arhitekture MCP, integrirali Playwright MCP in ustvarili svojega prvega agenta za avtomatizacijo brskalnika.
Modul 3: Napredovali ste v razvoju lastnih MCP strežnikov z Weather MCP strežnikom in obvladali orodja za odpravljanje napak.
Modul 4: Zdaj ste uporabili vse znanje za izdelavo praktičnega orodja za avtomatizacijo delovnega toka z GitHub repozitoriji.
🌟 Kaj ste osvojili:
- ✅ Ecosistem Microsoft Foundry Toolkit: modeli, agenti in vzorci integracij
- ✅ Arhitektura MCP: zasnova klient-strežnik, protokoli prenosa in varnost
- ✅ Razvojna orodja: od Playground do Inspectorja do produkcijske uvedbe
- ✅ Prilagojeni razvoj: izgradnja, testiranje in uvajanje lastnih MCP strežnikov
- ✅ Praktične uporabe: reševanje resničnih izzivov delovnih tokov z AI
🔮 Vaši naslednji koraki:
- Zgradite lastni MCP strežnik: uporabite te veščine za avtomatizacijo svojih edinstvenih delovnih tokov
- Pridružite se MCP skupnosti: delite svoje stvaritve in se učite od drugih
- Raziskujte napredno integracijo: povežite MCP strežnike z enterprise sistemi
- Prispevajte k odprtokodnim projektom: pomagajte izboljšati MCP orodja in dokumentacijo
Ne pozabite, ta delavnica je šele začetek. Ekosistem Model Context Protocol hitro napreduje in zdaj ste opremljeni, da ste na čelu AI-podprtih razvojnih orodij.
Hvala za vašo udeležbo in zavezanost učenju!
Upamo, da je ta delavnica vzpodbudila ideje, ki bodo preoblikovale način, kako gradite in uporabljate AI orodja na vaši razvojni poti.
Srečno kodiranje!
Kaj sledi
Čestitke ob zaključku vseh laboratorijev v Modulu 10!
- Nazaj na: Pregled Modula 10
- Nadaljujte na: Modul 11: MCP Server Hands-On Labs
Omejitev odgovornosti: Ta dokument je bil preveden z uporabo AI prevajalske storitve Co-op Translator. Čeprav si prizadevamo za natančnost, vas prosimo, da upoštevate, da avtomatizirani prevodi lahko vsebujejo napake ali netočnosti. Izvirni dokument v njegovem izvirnem jeziku je treba obravnavati kot avtoritativni vir. Za kritične informacije je priporočljiv strokovni človeški prevod. Ne odgovarjamo za morebitna nesporazume ali napačne interpretacije, ki izhajajo iz uporabe tega prevoda.