microsoft--mcp-for-beginners/translations/my/10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/lab4

🐙 Module 4: Practical MCP Development - Custom GitHub Clone Server

⚡ အမြန်စတင်ခြင်း: ၃၀ မိနစ်အတွင်း GitHub repository cloning နှင့် VS Code ပေါင်းစည်းမှုကို အလိုအလျောက်လုပ်ဆောင်ပေးနိုင်သည့် production-ready MCP server တစ်ခုကို တည်ဆောက်ပါ!

🎯 သင်ယူရမည့် ရည်မှန်းချက်များ

ဤလက်တွေ့လုပ်ငန်းအဆုံးသတ်သည့်အခါတွင် သင်သည်:

• ✅ အလုပ်တွင်အသုံးပြုနိုင်သော custom MCP server တစ်ခုကို ဖန်တီးနိုင်မည်
• ✅ MCP မှတဆင့် GitHub repository cloning လုပ်ဆောင်ချက်ကို အကောင်အထည်ဖော်နိုင်မည်
• ✅ Custom MCP server များကို VS Code နှင့် Agent Builder တွင် ပေါင်းစည်းမည်
• ✅ GitHub Copilot Agent Mode ကို custom MCP tools နှင့် အသုံးပြုနိုင်မည်
• ✅ Production ပတ်ဝန်းကျင်တွင် custom MCP server များကို စမ်းသပ် တပ်ဆင်နိုင်မည်

📋 လိုအပ်ချက်များ

• Labs 1-3 (MCP အခြေခံနှင့် တိုးတက်သောဖွံ့ဖြိုးမှုများ) ပြီးစီးပြီးဖြစ်ရမည်
• GitHub Copilot စာရင်းသွင်းခြင်း (အခမဲ့ စာရင်းသွင်းမှု ရနိုင်သည်)
• Microsoft Foundry Toolkit နှင့် GitHub Copilot extension များပါရှိသော VS Code
• Git CLI တပ်ဆင်ပြီး ဖြည့်စွက်ထားရှိရမည်

🏗️ စီမံကိန်းအနှုတ်ချုပ်

လက်တွေ့ ဖွံ့ဖြိုးရေး စိန်ခေါ်မှု

Developer များအနေဖြင့် GitHub repositories များကို clone ပြီး VS Code သို့မဟုတ် VS Code Insiders တွင်ဖွင့်ရန် မကြာခဏလိုအပ်ပါတယ်။ ဤ လုပ်ငန်းစဉ်ကို လက်မှတ်ဖြင့် ဆောင်ရွက်ရန် လိုအပ်သည်မှာ -

1. terminal/command prompt ကိုဖွင့်ခြင်း
2. လိုချင်သော ဖိုင်လမ်းကြောင်းသို့သွားရောက်ခြင်း
3. git clone command အား chạyခြင်း
4. clone လုပ်ထားသောဖိုင်လမ်းကြောင်းတွင် VS Code ကိုဖွင့်ခြင်း

MCP ဖြေရှင်းချက်က ဤလျှောက်လုပ်မှုအား အတိအကျ တစ်ခုတည်းသော command တစ်ခုသို့ ပြေးအောင် အလွယ်တကူ ပြုလုပ်ပေးပါသည်!

သင်တည်ဆောက်မည့်အရာ

GitHub Clone MCP Server (git_mcp_server) သည် အောက်ပါအချက်များကို ပံ့ပိုးပေးသည် -

လက္ခဏာ	ဖော်ပြချက်	အကျိုးထူး
🔄 Smart Repository Cloning	GitHub repos များကို ပြန်တိုးစစ်ဆေးကာ clone လုပ်ခြင်း	အလိုအလျောက် အမှားရှာဖွေမှု
📁 Intelligent Directory Management	ဖိုင်များကို လုံခြုံစွာ စစ်ဆေးနှင့် ဖန်တီးခြင်း	ဖိုင်များ မပယ်ဖျက်ဖောက်ပြန်မှုကို ကာကွယ်ပေးသည်
🚀 Cross-Platform VS Code Integration	VS Code/Insiders တွင် project များဖွင့်ပေးခြင်း	လုပ်ငန်းစဉ် ချောမွေ့စေရန်
🛡️ Robust Error Handling	အင်တာနက်၊ ခွင့်ပြုချက်၊ လမ်းကြောင်းပြဿနာများကို ကိုင်တွယ်နိုင်မှု	Production-ready ယုံကြည်စိတ်ချရမှု

---

📖 အဆင့်တစ်ဆင့် လုပ်ဆောင်ခြင်း

အဆင့် ၁: Agent Builder တွင် GitHub Agent ဖန်တီးခြင်း

1. Microsoft Foundry Toolkit extension မှတဆင့် Agent Builder ကို ဖွင့်ပါ

2. အောက်ပါ configuration ဖြင့် အေးဂျင့်အသစ်တစ်ခု ဖန်တီးပါ:

   Agent Name: GitHubAgent
   

3. Custom MCP server ကို စတင်ဆောက်ရန်:

   • Tools → Add Tool → MCP Server သို့ သွားပါ
   • "Create A new MCP Server" ကိုရွေးချယ်ပါ
   • ကျယ်ပြန့်စွာ အသုံးပြုနိုင်သော Python template ကို ရွေးပါ
   • Server Name: git_mcp_server

အဆင့် ၂: GitHub Copilot Agent Mode ဖြင့် ဆက်ဆံခြင်း

1. VS Code တွင် GitHub Copilot ကို ဖွင့်ပါ (Ctrl/Cmd + Shift + P → "GitHub Copilot: Open")
2. Copilot အပြင်တွင် Agent Model ကို ရွေးချယ်ပါ
3. ပိုမိုအတိအကျ reasoning များစွာလုပ်ဆောင်နိုင်သော Claude 3.7 model ကို ရွေးချယ်ပါ
4. Tool များသုံးရန်အတွက် MCP ပေါင်းစည်းမှုကို ဖွင့်ပါ

💡 အသုံးချရန် အကြံပေးချက်: Claude 3.7 သည် ဖွံ့ဖြိုးမှု လုပ်ငန်းစဉ်များနှင့် အမှား ကိုင်တွယ်နည်းများကို ပိုမိုနက်ရှိုင်းစွာ နားလည်ပေးတတ်သည်။

အဆင့် ၃: MCP Server အဓိက လုပ်ဆောင်ချက်များ ကို အကောင်အထည်ဖော်ခြင်း

GitHub Copilot Agent Mode အသုံးပြု၍ အောက်ပါ prompt အသေးစိတ်ကို အသုံးပြုပြီး ဖန်တီးပါ:

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

အဆင့် ၄: MCP Server ကို စမ်းသပ်ခြင်း

4a. Agent Builder တွင် စမ်းသပ်ခြင်း

1. Agent Builder အတွက် debug configuration ကို ဖွင့်ပါ
2. အောက်ပါ system prompt ဖြင့် အေးဂျင့် Configure လုပ်ပါ:

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"

မျှော်မှန်းရလဒ်များ:

• ✅ လမ်းကြောင်းအတည်ပြုချက်နှင့်အတူ စတိုင်လ်စနစ် cloning အောင်မြင်မှု
• ✅ VS Code ကို အလိုအလျောက် ဖွင့်ခြင်း
• ✅ ပျက်ကွက်မှုများအတွက် ထင်ရှားသော အမှားစာလုံးများ
• ✅ အထူးအခြေအနေများကို မှန်ကန်စွာ ကိုင်တွယ်နိုင်မှု

4b. MCP Inspector တွင် စမ်းသပ်ခြင်း

---

🎉 သင်ပြုလုပ်နိုင်ပြီ! လက်တွေ့အသုံးပြုနိုင်ပြီး production-ready MCP server တစ်ခုကို ဖြေရှင်းသူအနေဖြင့် အောင်မြင်စွာ စတင်တည်ဆောက်လိုက်ပါပြီ။ သင်၏ custom GitHub clone server သည် MCP ၏စွမ်းအားကို developer များအတွက် စီမံခန့်ခွဲမှုများကို လွယ်ကူအောင် ပြုလုပ်ပေးနိုင်မှုကို ပြသနေပါသည်။

🏆 ရရှိထားသည့်အောင်မြင်မှုများ:

• ✅ MCP Developer - Custom MCP server ကို ဖန်တီးခဲ့သူ
• ✅ Workflow Automator - ဖွံ့ဖြိုးရေး လုပ်ငန်းစဉ်များ စနစ်တကျ လွယ်ကူစေရန်
• ✅ Integration Expert - ဖွံ့ဖြိုးရေး ကိရိယာများစွာ ပေါင်းစည်းနိုင်သူ
• ✅ Production Ready - deploy ချနိုင်သော ဖြေရှင်းချက်များ တည်ဆောက်သူ

---

🎓 သင်တန်းပြီးဆုံးခြင်း: Model Context Protocol နှင့် သင်၏ ခရီးစဉ်

လေးစားရပါသော သင်တန်းဝင်များ,

Model Context Protocol သင်တန်း ၄ Module အားလုံးပြီးဆုံးခြင်းအတွက် ဂုဏ်ယူပါသည်! Microsoft Foundry Toolkit ၏ အခြေခံစတင်လေ့လာမှစ၍ လက်တွေ့အသုံးပြုနိုင်သော production-ready MCP server များဖန်တီးနိုင်အောင် ချဲ့ထွင်နိုင်ခဲ့ပါသည်။

🚀 သင်၏ သင်ယူရေး လမ်းကြောင်း အကျဉ်းချုံး:

Module 1: Microsoft Foundry Toolkit အခြေခံများ၊ model စမ်းသပ်မှုနှင့် ပထမဆုံး AI agent ဖန်တီးခြင်း ကို စတင်လေ့လာခဲ့သည်။

Module 2: MCP အဆောက်အအုံ၊ Playwright MCP ပေါင်းစည်းမှုနှင့် ပထမဆုံး browser automation agent တိုု့ကို ဖွံ့ဖြိုးခဲ့သည်။

Module 3: Weather MCP server အသုံးပြုပြီး custom MCP server ဖန်တီးခြင်းနှင့် debugging ကိရိယာများ ကျွမ်းကျင်မှု ရရှိခဲ့သည်။

Module 4: လက်တွေ့ GitHub repository workflow automation ကိရိယာ ဖန်တီးခြင်းအပိုင်းတွင် မိမိကွာတာတွေကို စတင်အသုံးချနိုင်ခဲ့သည်။

🌟 သင်ယူပြီးအောင်မြင်ခဲ့သူများ:

• ✅ Microsoft Foundry Toolkit ကမ္ဘာပတ်လည်: Models, agents, ပေါင်းစည်းနည်းများ
• ✅ MCP Architecture: Client-server ဒီဇိုင်း၊ ထွက်သွားမှု protocols နှင့် လုံခြုံရေး
• ✅ Developer Tools: Playground မှ Inspector တိုင်အောင် နှင့် production deployment အထိ
• ✅ Custom Development: ကိုယ်ပိုင် MCP server များ ဖန်တီး၊ စမ်းသပ်နှင့် တပ်ဆင်နိုင်မှု
• ✅ လက်တွေ့လျှောက်လွှာများ: AI ဖြင့် လုပ်ငန်းစဉ်စိန်ခေါ်မှုများကို ဖြေရှင်းနိုင်မှု

🔮 နောက်တစ်ဆင့်များ

1. ကိုယ်ပိုင် MCP server တည်ဆောက်ပါ: ကိုယ်ပိုင် workflow များကို အလိုအလျောက်လုပ်ဆောင်ရန်
2. MCP ကွန်ယက်တွင် ပူးပေါင်းပါ: မိတ်ဖက်များနှင့် မှတဆင့် မျှဝေပေးပါ
3. တိုးတက်ထပ်ဆောင်း ပေါင်းစည်းမှု လေ့လာပါ: MCP servers များကို စီးပွားရေးစနစ်များနှင့် ချိတ်ဆက်ရန်
4. Open Source တွင် ပါဝင်ပါ: MCP ကိရိယာများနှင့် စာရွက်စာတမ်းများ တိုးတက်စေရန် သူများအား ကူညီပါ

သတိပြုပါ - ဤသင်တန်းမှာ စတင်အဆင့်သာဖြစ်ပြီး Model Context Protocol ကမ္ဘာကြီးသည် အလွန်မြန်မြန်ပြောင်းလဲနေပါသည်၊ သင်သည် AI-အခြေခံ ဖွံ့ဖြိုးရေး ကိရိယာများ၏မိတ်ဆက်တိုးတက်မှုမောင်းသူတစ်ဦးခေါ်ယူရန် ပြင်ဆင်ပြီး ဖြစ်ပါသည်။

တက်ကြွစွာ ပါဝင်ပေးမှုနှင့် သင်ယူမှုအတွက် ကျေးဇူးအထူးတင်ရှိပါသည်!

သင်တန်းသည် သင်၏ ဖွံ့ဖြိုးရေး ခရီးစဉ်တွင် AI ကိရိယာများနှင့် အဆက်အသွယ်ပြုလုပ်နည်းကို ပြောင်းလဲပေးမည့် အတွေးအမြင်များ လှည့်ဖြူးပေးသလိမ့်မည်ဟု မျှော်လင့်ပါသည်။

Coding ကောင်းသောနေ့များဖြစ်ပါစေ!

---

နောက်တစ်ဆင့်

Module 10 အတွက် labs အားလုံးပြီးစီးခြင်းအတွက် ဂုဏ်ယူပါသည်!

• နောက်သို့: Module 10 Overview
• ဆက်လက် လုပ်ဆောင်ရန်: Module 11: MCP Server Hands-On Labs

---

ပြောကြားချက် ဤစာတမ်းကို AI ဘာသာပြန်ဝန်ဆောင်မှု Co-op Translator အသုံးပြု၍ ဘာသာပြန်ထားပါသည်။ ကျွန်ုပ်တို့သည် တိကျမှန်ကန်မှုအတွက် ကြိုးပမ်းနေသော်လည်း၊ စက်ကိရိယာဘာသာပြန်ခြင်းများတွင် အမှားများ သို့မဟုတ် မှားယွင်းချက်များ ပါဝင်နိုင်ကြောင်း သတိပြုပါရန် လိုအပ်ပါသည်။ မူလစာတမ်းကို မူရင်းဘာသာဖြင့်သာ ယုံကြည်စိတ်ချရသော အချက်အလက်အဖြစ် သတ်မှတ်သင့်သည်။ အရေးကြီးသည့် သတင်းအချက်အလက်များအတွက် ပရော်ဖက်ရှင်နယ် လူသားဘာသာပြန်သူဝန်ဆောင်မှုကို အကြံပြုပါသည်။ ဤဘာသာပြန်ချက်ကို အသုံးပြုခြင်းမှ ဖြစ်ပေါ်လာသော နားလည်မှုကွာခြားမှုများ သို့မဟုတ် မမှန်ကန်သော အသုံးပြုမှုများအတွက် ကျွန်ုပ်တို့ တာဝန်မခံပါ။