# 🐙 មូឌុល 4៖ ការអភិវឌ្ឍ MCP ជាក់ស្តែង - ម៉ាស៊ីនស្ទើរចម្លង GitHub ផ្ទាល់ខ្លួន

![Duration](https://img.shields.io/badge/Duration-30_minutes-blue?style=flat-square)
![Difficulty](https://img.shields.io/badge/Difficulty-Intermediate-orange?style=flat-square)
![MCP](https://img.shields.io/badge/MCP-Custom%20Server-purple?style=flat-square&logo=github)
![VS Code](https://img.shields.io/badge/VS%20Code-Integration-blue?style=flat-square&logo=visualstudiocode)
![GitHub Copilot](https://img.shields.io/badge/GitHub%20Copilot-Agent%20Mode-green?style=flat-square&logo=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"
```

![Agent Builder Testing](../../../../translated_images/km/DebugAgent.81d152370c503241.webp)

**លទ្ធផលដែលរំពឹងទុក:**
- ✅ ចម្លងដោយជោគជ័យជាមួយការបញ្ជាក់ផ្លូវ
- ✅ បើក VS Code ដោយស្វ័យប្រវត្តិ
- ✅ សារ​កំហុស​បង្ហាញ​ជាក់លាក់​សម្រាប់ស្ថានការណ៍មិនត្រឹមត្រូវ
- ✅ ដោះស្រាយបញ្ហាក្រៅប្រព័ន្ធបានត្រឹមត្រូវ

#### 4b. សាកល្បងក្នុង MCP Inspector


![MCP Inspector Testing](../../../../translated_images/km/DebugInspector.eb5c95f94c69a8ba.webp)

---



**🎉អបអរសាទរ!** អ្នកបានបង្កើតម៉ាស៊ីនមេ 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 -->