wehub-resource-sync
213 lines
18 KiB
Markdown
213 lines
18 KiB
Markdown
# 🐙 មូឌុល 4៖ ការអភិវឌ្ឍ MCP ជាក់ស្តែង - ម៉ាស៊ីនស្ទើរចម្លង GitHub ផ្ទាល់ខ្លួន
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
> **⚡ ចាប់ផ្តើមយ៉ាងរហ័ស៖** បង្កើតម៉ាស៊ីនមេ MCP ដែលត្រៀមទុកដល់ផលិតកម្ម ដែលបង្ក automat្របេសកកម្មចម្លងឃ្លឹប GitHub និងការរួមបញ្ចូល VS Code ក្នុងរយៈពេលត្រឹម 30 នាទីប៉ុណ្ណោះ!
|
|
|
|
## 🎯 គោលដៅរៀន
|
|
|
|
នៅចុងបញ្ចប់នៃមន្ទីរពិសោធន៍នេះ អ្នកនឹងអាច៖
|
|
|
|
- ✅ បង្កើតម៉ាស៊ីនមេ MCP ផ្ទាល់ខ្លួនសម្រាប់ដំណើរការអភិវឌ្ឍន៍ក្នុងពិភពពិត
|
|
- ✅ អនុវត្តមុខងារចម្លងឃ្លឹប GitHub តាមរយៈ MCP
|
|
- ✅ រួមបញ្ចូលម៉ាស៊ីនមេ MCP ផ្ទាល់ខ្លួនជាមួយ VS Code និង Agent Builder
|
|
- ✅ ប្រើម៉ូត GitHub Copilot Agent ជាមួយឧបករណ៍ MCP ផ្ទាល់ខ្លួន
|
|
- ✅ សាកល្បង និងដាក់ឲ្យដំណើរការម៉ាស៊ីនមេ MCP ផ្ទាល់ខ្លួនក្នុងបរិយាកាសផលិតកម្ម
|
|
|
|
## 📋 លក្ខខណ្ឌមុនត្រូវមាន
|
|
|
|
- បានបញ្ចប់មន្ទីរពិសោធន៍ 1-3 (មូលដ្ឋាន និងការអភិវឌ្ឍន៍ដែលមានជំនាញខ្ពស់សម្រាប់ MCP)
|
|
- ការជាវ GitHub Copilot ([មានការចុះឈ្មោះដោយឥតគិតថ្លៃ](https://github.com/github-copilot/signup))
|
|
- VS Code ជាមួយ Microsoft Foundry Toolkit និងបន្ថែម GitHub Copilot
|
|
- កម្មវិធី 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៖ បង្កើត GitHub Agent ក្នុង Agent Builder
|
|
|
|
1. **បើក Agent Builder** តាមរយៈការបន្ថែម Microsoft Foundry Toolkit
|
|
2. **បង្កើតភ្នាក់ងារថ្មី** ជាមួយការបញ្ជាក់ខាងក្រោម៖
|
|
```
|
|
Agent Name: GitHubAgent
|
|
```
|
|
|
|
3. **ចាប់ផ្តើមម៉ាស៊ីនមេ MCP ផ្ទាល់ខ្លួន:**
|
|
- ទៅកាន់ **ឧបករណ៍** → **បន្ថែមឧបករណ៍** → **ម៉ាស៊ីនមេ MCP**
|
|
- ជ្រើស **"បង្កើតម៉ាស៊ីនមេ MCP ថ្មី"**
|
|
- ជ្រើស **គំរូ Python** ដើម្បីមានភាពងាយស្រួលបំផុត
|
|
- **ឈ្មោះម៉ាស៊ីនមេ:** `git_mcp_server`
|
|
|
|
### ជំហាន 2៖ កំណត់ម៉ូត GitHub Copilot Agent
|
|
|
|
1. **បើក GitHub Copilot** ក្នុង VS Code (Ctrl/Cmd + Shift + P → "GitHub Copilot: Open")
|
|
2. **ជ្រើសម៉ូតភ្នាក់ងារ** នៅក្នុងចំណុចប្រទាក់ Copilot
|
|
3. **ជ្រើសម៉ូត Claude 3.7** សម្រាប់សមត្ថភាពគិតរឿងកើនឡើង
|
|
4. **បើករួមបញ្ចូល MCP** សម្រាប់ការចូលប្រើឧបករណ៍
|
|
|
|
> **💡 ក្បួនណែនាំ៖** Claude 3.7 ផ្ដល់នូវការយល់ដឹងល្អបំផុតអំពីដំណើរការអភិវឌ្ឍន៍ និងលំនាំដោះស្រាយកំហុស។
|
|
|
|
### ជំហាន 3៖ អនុវត្តមុខងារ MCP Server សំខាន់ៗ
|
|
|
|
**ប្រើប្រធានបទលម្អិតខាងក្រោមជាមួយម៉ូត GitHub Copilot Agent៖**
|
|
|
|
```
|
|
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. **ចាប់ផ្តើមការកំណត់ debug** សម្រាប់ 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 សម្រាប់ផលិតកម្ម ដែលដោះស្រាយបញ្ហាផ្នែកអភិវឌ្ឍន៍ពិតប្រាកដ។
|
|
|
|
### 🚀 សង្ខេបផ្លូវរៀនរបស់អ្នក៖
|
|
|
|
**[Module 1](../lab1/README.md)**៖ អ្នកបានចាប់ផ្តើមដោយស្វែងយល់មូលដ្ឋាន Microsoft Foundry Toolkit ការធ្វើតេស្តម៉ូឌែល និងបង្កើតភ្នាក់ងារហ៊ុន AI ដំបូងរបស់អ្នក។
|
|
|
|
**[Module 2](../lab2/README.md)**៖ អ្នកបានរៀនអត្ថបទ MCP, រួមបញ្ចូល Playwright MCP និងបង្កើតភ្នាក់ងាររូបមន្តវ៉ិបងារ។
|
|
|
|
**[Module 3](../lab3/README.md)**៖ អ្នកបានកំណត់ទឹកដីទៅការអភិវឌ្ឍម៉ាស៊ីនមេ MCP ផ្ទាល់ខ្លួនជាមួយម៉ាស៊ីនមេ Weather MCP និងចេះប្រើឧបករណ៍ដោះស្រាយបញ្ហា។
|
|
|
|
**[Module 4](../lab4/README.md)**៖ ឥឡូវនេះ អ្នកបានអនុវត្តគ្រប់យ៉ាងដើម្បីបង្កើតឧបករណ៍បង្កើតកម្មវិធីស្វ័យប្រវត្តិជាក់ស្តែងសម្រាប់គម្រោងឃ្លឹប GitHub។
|
|
|
|
### 🌟 អ្វីដែលអ្នកបានស្គាល់៖
|
|
|
|
- ✅ **Microsoft Foundry Toolkit**៖ ម៉ូឌែល ភ្នាក់ងារនិងគំរូរួមបញ្ចូល
|
|
- ✅ **សំណុំ MCP**៖ រចនាសម្ព័ន្ធម៉ាស៊ីនអតិថិជន-ម៉ាស៊ីនមេ, ពិធីការផ្ទេរ និងសុវត្ថិភាព
|
|
- ✅ **ឧបករណ៍អភិវឌ្ឍន៍**៖ ពី Playground ទៅ Inspector និងដាក់កម្មវិធីទៅផលិតកម្ម
|
|
- ✅ **អភិវឌ្ឍផ្ទាល់ខ្លួន**៖ បង្កើត សាកល្បង និងដាក់ម៉ាស៊ីនមេ MCP ផ្ទាល់ខ្លួន
|
|
- ✅ **អនុវត្តជាក់ស្តែង**៖ ដោះស្រាយបញ្ហាដំណើរការពិតប្រាកដជាមួយ AI
|
|
|
|
### 🔮 ជំហានបន្ទាប់របស់អ្នក៖
|
|
|
|
1. **បង្កើតម៉ាស៊ីនមេ MCP ផ្ទាល់ខ្លួន**៖ អនុវត្តជំនាញទាំងនេះដើម្បីបង្កើតដំណើរការអ្នកផ្ទាល់
|
|
2. **ចូលរួមសហគមន៍ MCP**៖ ចែករំលែកការបង្កើតរបស់អ្នក និងស្វែងយល់ពីអ្នកដទៃ
|
|
3. **ស្វែងយល់ការរួមបញ្ចូលកម្រិតខ្ពស់**៖ ភ្ជាប់ម៉ាស៊ីនមេ MCP ទៅប្រព័ន្ធសហគ្រាស
|
|
4. **ចូលរួមអោយភាពប្រសើរ Open Source**៖ ជួយការកែលម្អឧបករណ៍ MCP និងឯកសារ
|
|
|
|
ចាំបាច់ រាល់វគ្គបណ្ដុះបណ្ដាលនេះគឺជាចាប់ផ្តើមប៉ុណ្ណោះ។ គួរសមធនធាន Model Context Protocol កំពុងរីកចម្រើនយ៉ាងលឿន ហើយឥឡូវនេះ អ្នករួចជាស្រេចរួចរាល់ដើម្បីនៅជាមួយវា។
|
|
|
|
**អរគុណសម្រាប់ការចូលរួម និងការប្តេជ្ញាចិត្តក្នុងការរៀន!**
|
|
|
|
យើងសង្ឃឹមថាវគ្គបណ្ដុះបណ្ដាលនេះបានបង្កើតមគ្គុទេសក៏ដែលនឹងបំលែងរបៀបដែលអ្នកបង្កើត និងធ្វើការជាមួយឧបករណ៍ AI ក្នុងការធ្វើដំណើរអភិវឌ្ឍរបស់អ្នក។
|
|
|
|
**រីករាយក្នុងការសរសេរកូដ!**
|
|
|
|
---
|
|
|
|
## វាង្វាន់បន្ទាប់
|
|
|
|
អបអរសាទរចំពោះការបញ្ចប់មន្ទីរពិសោធន៍ទាំងអស់ក្នុងមូឌុល 10!
|
|
|
|
- ត្រឡប់ទៅ៖ [Module 10 Overview](../README.md)
|
|
- បន្តទៅ៖ [Module 11: MCP Server Hands-On Labs](../../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 --> |