wehub-resource-sync
397 lines
12 KiB
Markdown
397 lines
12 KiB
Markdown
# 🔧 Modul 3: Avansert MCP-utvikling med Microsoft Foundry Toolkit
|
||
|
||
|
||
|
||
|
||
|
||
|
||
|
||
## 🎯 Læringsmål
|
||
|
||
Innen slutten av dette laboratoriet vil du kunne:
|
||
|
||
- ✅ Lage egendefinerte MCP-servere ved hjelp av Microsoft Foundry Toolkit
|
||
- ✅ Konfigurere og bruke den nyeste MCP Python SDK (v1.9.3)
|
||
- ✅ Sette opp og bruke MCP Inspector for feilsøking
|
||
- ✅ Feilsøke MCP-servere i både Agent Builder og Inspector-miljøer
|
||
- ✅ Forstå avanserte arbeidsflyter for MCP-serverutvikling
|
||
|
||
## 📋 Forutsetninger
|
||
|
||
- Fullført Laboratorium 2 (MCP Grunnleggende)
|
||
- VS Code med Microsoft Foundry Toolkit-utvidelse installert
|
||
- Python 3.10+ miljø
|
||
- Node.js og npm for Inspector-oppsett
|
||
|
||
## 🏗️ Det du skal bygge
|
||
|
||
I dette laboratoriet oppretter du en **Weather MCP Server** som demonstrerer:
|
||
- Egnet MCP-serverimplementering
|
||
- Integrasjon med Microsoft Foundry Toolkit Agent Builder
|
||
- Profesjonelle feilsøkingsarbeidsflyter
|
||
- Moderne MCP SDK bruksmønstre
|
||
|
||
---
|
||
|
||
## 🔧 Oversikt over kjernekomponenter
|
||
|
||
### 🐍 MCP Python SDK
|
||
Model Context Protocol Python SDK gir grunnlaget for å bygge egendefinerte MCP-servere. Du skal bruke versjon 1.9.3 med forbedrede feilsøkingsmuligheter.
|
||
|
||
### 🔍 MCP Inspector
|
||
Et kraftig feilsøkingsverktøy som tilbyr:
|
||
- Sanntidsovervåking av server
|
||
- Visualisering av verktøykjøring
|
||
- Nettverksforespørsel/-respons inspeksjon
|
||
- Interaktiv testmiljø
|
||
|
||
---
|
||
|
||
## 📖 Trinnvis implementering
|
||
|
||
### Trinn 1: Opprett en WeatherAgent i Agent Builder
|
||
|
||
1. **Start Agent Builder** i VS Code via Microsoft Foundry Toolkit-utvidelsen
|
||
2. **Lag en ny agent** med følgende konfigurasjon:
|
||
- Agentnavn: `WeatherAgent`
|
||
|
||
|
||
|
||
### Trinn 2: Initialiser MCP Server-prosjekt
|
||
|
||
1. **Gå til Tools** → **Add Tool** i Agent Builder
|
||
2. **Velg "MCP Server"** fra tilgjengelige alternativer
|
||
3. **Velg "Create A new MCP Server"**
|
||
4. **Velg malen `python-weather`**
|
||
5. **Gi serveren navn:** `weather_mcp`
|
||
|
||
|
||
|
||
### Trinn 3: Åpne og undersøk prosjektet
|
||
|
||
1. **Åpne det genererte prosjektet** i VS Code
|
||
2. **Gå gjennom prosjektstrukturen:**
|
||
```
|
||
weather_mcp/
|
||
├── src/
|
||
│ ├── __init__.py
|
||
│ └── server.py
|
||
├── inspector/
|
||
│ ├── package.json
|
||
│ └── package-lock.json
|
||
├── .vscode/
|
||
│ ├── launch.json
|
||
│ └── tasks.json
|
||
├── pyproject.toml
|
||
└── README.md
|
||
```
|
||
|
||
### Trinn 4: Oppgrader til nyeste MCP SDK
|
||
|
||
> **🔍 Hvorfor oppgradere?** Vi ønsker å bruke den nyeste MCP SDK (v1.9.3) og Inspector-tjenesten (0.14.0) for forbedrede funksjoner og bedre feilsøkingsmuligheter.
|
||
|
||
#### 4a. Oppdater Python-avhengigheter
|
||
|
||
**Rediger `pyproject.toml`:** oppdater [./code/weather_mcp/pyproject.toml](../../../../10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/lab3/code/weather_mcp/pyproject.toml)
|
||
|
||
|
||
#### 4b. Oppdater Inspector-konfigurasjon
|
||
|
||
**Rediger `inspector/package.json`:** oppdater [./code/weather_mcp/inspector/package.json](../../../../10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/lab3/code/weather_mcp/inspector/package.json)
|
||
|
||
#### 4c. Oppdater Inspector-avhengigheter
|
||
|
||
**Rediger `inspector/package-lock.json`:** oppdater [./code/weather_mcp/inspector/package-lock.json](../../../../10-StreamliningAIWorkflowsBuildingAnMCPServerWithAIToolkit/lab3/code/weather_mcp/inspector/package-lock.json)
|
||
|
||
> **📝 Merk:** Denne filen inneholder omfattende avhengighetsdefinisjoner. Nedenfor vises det essensielle oppsettet - den fullstendige filen sikrer korrekt avhengighetsløsning.
|
||
|
||
|
||
> **⚡ Full Package Lock:** Den komplette package-lock.json inneholder ~3000 linjer med avhengighetsdefinisjoner. Ovenfor vises hovedstrukturen - bruk den medfølgende filen for fullstendig avhengighetsløsning.
|
||
|
||
### Trinn 5: Konfigurer VS Code feilsøking
|
||
|
||
*Merk: Kopier filen i angitt sti for å erstatte tilsvarende lokal fil*
|
||
|
||
#### 5a. Oppdater lanseringskonfigurasjon
|
||
|
||
**Rediger `.vscode/launch.json`:**
|
||
|
||
```json
|
||
{
|
||
"version": "0.2.0",
|
||
"configurations": [
|
||
{
|
||
"name": "Attach to Local MCP",
|
||
"type": "debugpy",
|
||
"request": "attach",
|
||
"connect": {
|
||
"host": "localhost",
|
||
"port": 5678
|
||
},
|
||
"presentation": {
|
||
"hidden": true
|
||
},
|
||
"internalConsoleOptions": "neverOpen",
|
||
"postDebugTask": "Terminate All Tasks"
|
||
},
|
||
{
|
||
"name": "Launch Inspector (Edge)",
|
||
"type": "msedge",
|
||
"request": "launch",
|
||
"url": "http://localhost:6274?timeout=60000&serverUrl=http://localhost:3001/sse#tools",
|
||
"cascadeTerminateToConfigurations": [
|
||
"Attach to Local MCP"
|
||
],
|
||
"presentation": {
|
||
"hidden": true
|
||
},
|
||
"internalConsoleOptions": "neverOpen"
|
||
},
|
||
{
|
||
"name": "Launch Inspector (Chrome)",
|
||
"type": "chrome",
|
||
"request": "launch",
|
||
"url": "http://localhost:6274?timeout=60000&serverUrl=http://localhost:3001/sse#tools",
|
||
"cascadeTerminateToConfigurations": [
|
||
"Attach to Local MCP"
|
||
],
|
||
"presentation": {
|
||
"hidden": true
|
||
},
|
||
"internalConsoleOptions": "neverOpen"
|
||
}
|
||
],
|
||
"compounds": [
|
||
{
|
||
"name": "Debug in Agent Builder",
|
||
"configurations": [
|
||
"Attach to Local MCP"
|
||
],
|
||
"preLaunchTask": "Open Agent Builder",
|
||
},
|
||
{
|
||
"name": "Debug in Inspector (Edge)",
|
||
"configurations": [
|
||
"Launch Inspector (Edge)",
|
||
"Attach to Local MCP"
|
||
],
|
||
"preLaunchTask": "Start MCP Inspector",
|
||
"stopAll": true
|
||
},
|
||
{
|
||
"name": "Debug in Inspector (Chrome)",
|
||
"configurations": [
|
||
"Launch Inspector (Chrome)",
|
||
"Attach to Local MCP"
|
||
],
|
||
"preLaunchTask": "Start MCP Inspector",
|
||
"stopAll": true
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
**Rediger `.vscode/tasks.json`:**
|
||
|
||
```
|
||
{
|
||
"version": "2.0.0",
|
||
"tasks": [
|
||
{
|
||
"label": "Start MCP Server",
|
||
"type": "shell",
|
||
"command": "python -m debugpy --listen 127.0.0.1:5678 src/__init__.py sse",
|
||
"isBackground": true,
|
||
"options": {
|
||
"cwd": "${workspaceFolder}",
|
||
"env": {
|
||
"PORT": "3001"
|
||
}
|
||
},
|
||
"problemMatcher": {
|
||
"pattern": [
|
||
{
|
||
"regexp": "^.*$",
|
||
"file": 0,
|
||
"location": 1,
|
||
"message": 2
|
||
}
|
||
],
|
||
"background": {
|
||
"activeOnStart": true,
|
||
"beginsPattern": ".*",
|
||
"endsPattern": "Application startup complete|running"
|
||
}
|
||
}
|
||
},
|
||
{
|
||
"label": "Start MCP Inspector",
|
||
"type": "shell",
|
||
"command": "npm run dev:inspector",
|
||
"isBackground": true,
|
||
"options": {
|
||
"cwd": "${workspaceFolder}/inspector",
|
||
"env": {
|
||
"CLIENT_PORT": "6274",
|
||
"SERVER_PORT": "6277",
|
||
}
|
||
},
|
||
"problemMatcher": {
|
||
"pattern": [
|
||
{
|
||
"regexp": "^.*$",
|
||
"file": 0,
|
||
"location": 1,
|
||
"message": 2
|
||
}
|
||
],
|
||
"background": {
|
||
"activeOnStart": true,
|
||
"beginsPattern": "Starting MCP inspector",
|
||
"endsPattern": "Proxy server listening on port"
|
||
}
|
||
},
|
||
"dependsOn": [
|
||
"Start MCP Server"
|
||
]
|
||
},
|
||
{
|
||
"label": "Open Agent Builder",
|
||
"type": "shell",
|
||
"command": "echo ${input:openAgentBuilder}",
|
||
"presentation": {
|
||
"reveal": "never"
|
||
},
|
||
"dependsOn": [
|
||
"Start MCP Server"
|
||
],
|
||
},
|
||
{
|
||
"label": "Terminate All Tasks",
|
||
"command": "echo ${input:terminate}",
|
||
"type": "shell",
|
||
"problemMatcher": []
|
||
}
|
||
],
|
||
"inputs": [
|
||
{
|
||
"id": "openAgentBuilder",
|
||
"type": "command",
|
||
"command": "ai-mlstudio.agentBuilder",
|
||
"args": {
|
||
"initialMCPs": [ "local-server-weather_mcp" ],
|
||
"triggeredFrom": "vsc-tasks"
|
||
}
|
||
},
|
||
{
|
||
"id": "terminate",
|
||
"type": "command",
|
||
"command": "workbench.action.tasks.terminate",
|
||
"args": "terminateAll"
|
||
}
|
||
]
|
||
}
|
||
```
|
||
|
||
|
||
---
|
||
|
||
## 🚀 Kjøre og teste MCP-serveren din
|
||
|
||
### Trinn 6: Installer avhengigheter
|
||
|
||
Etter å ha gjort konfigurasjonsendringene, kjør følgende kommandoer:
|
||
|
||
**Installer Python-avhengigheter:**
|
||
```bash
|
||
uv sync
|
||
```
|
||
|
||
**Installer Inspector-avhengigheter:**
|
||
```bash
|
||
cd inspector
|
||
npm install
|
||
```
|
||
|
||
### Trinn 7: Feilsøk med Agent Builder
|
||
|
||
1. **Trykk F5** eller bruk **"Debug in Agent Builder"** konfigurasjonen
|
||
2. **Velg sammensatt konfigurasjon** fra feilsøkingspanelet
|
||
3. **Vent på at serveren starter** og at Agent Builder åpner
|
||
4. **Test din vær-MCP-server** med naturlige språkspørringer
|
||
|
||
Skriv inn en prompt som denne
|
||
|
||
SYSTEM_PROMPT
|
||
|
||
```
|
||
You are my weather assistant
|
||
```
|
||
|
||
USER_PROMPT
|
||
|
||
```
|
||
How's the weather like in Seattle
|
||
```
|
||
|
||
|
||
|
||
### Trinn 8: Feilsøk med MCP Inspector
|
||
|
||
1. **Bruk "Debug in Inspector"** konfigurasjonen (Edge eller Chrome)
|
||
2. **Åpne Inspector-grensesnittet** på `http://localhost:6274`
|
||
3. **Utforsk det interaktive testmiljøet:**
|
||
- Se tilgjengelige verktøy
|
||
- Test verktøykjøring
|
||
- Overvåk nettverksforespørsler
|
||
- Feilsøk serverresponsene
|
||
|
||
|
||
|
||
---
|
||
|
||
## 🎯 Viktige læringsutbytter
|
||
|
||
Ved å fullføre dette laboratoriet har du:
|
||
|
||
- [x] **Opprettet en egendefinert MCP-server** ved hjelp av Microsoft Foundry Toolkit-maler
|
||
- [x] **Oppgradert til nyeste MCP SDK** (v1.9.3) for bedre funksjonalitet
|
||
- [x] **Konfigurert profesjonelle feilsøkingsarbeidsflyter** for både Agent Builder og Inspector
|
||
- [x] **Satt opp MCP Inspector** for interaktiv servertesting
|
||
- [x] **Mestring av VS Code feilsøkingskonfigurasjoner** for MCP-utvikling
|
||
|
||
## 🔧 Avanserte funksjoner som ble utforsket
|
||
|
||
| Funksjon | Beskrivelse | Bruksområde |
|
||
|---------|-------------|----------|
|
||
| **MCP Python SDK v1.9.3** | Nyeste protokollimplementasjon | Moderne serverutvikling |
|
||
| **MCP Inspector 0.14.0** | Interaktivt feilsøkingsverktøy | Sanntidstesting av server |
|
||
| **VS Code Debugging** | Integrert utviklingsmiljø | Profesjonell feilsøkingsarbeidsflyt |
|
||
| **Agent Builder Integration** | Direkte Microsoft Foundry Toolkit-tilknytning | Helhetlig agenttesting |
|
||
|
||
## 📚 Ytterligere ressurser
|
||
|
||
- [MCP Python SDK Dokumentasjon](https://modelcontextprotocol.io/docs/sdk/python)
|
||
- [Microsoft Foundry Toolkit Utvidelsesguide](https://code.visualstudio.com/docs/ai/ai-toolkit)
|
||
- [VS Code Feilsøkingsdokumentasjon](https://code.visualstudio.com/docs/editor/debugging)
|
||
- [Model Context Protocol Spesifikasjon](https://modelcontextprotocol.io/docs/concepts/architecture)
|
||
|
||
---
|
||
|
||
**🎉 Gratulerer!** Du har fullført Laboratorium 3 og kan nå lage, feilsøke og distribuere egendefinerte MCP-servere ved hjelp av profesjonelle utviklingsarbeidsflyter.
|
||
|
||
### 🔜 Fortsett til neste modul
|
||
|
||
Klar til å bruke MCP-ferdighetene dine i en virkelig utviklingsarbeidsflyt? Fortsett til **[Modul 4: Praktisk MCP-utvikling – Egnet GitHub-klone-server](../lab4/README.md)** hvor du skal:
|
||
- Bygge en produksjonsklar MCP-server som automatiserer GitHub-repositorieoperasjoner
|
||
- Implementere GitHub repositorie-kloning via MCP
|
||
- Integrere egendefinerte MCP-servere med VS Code og GitHub Copilot Agent Mode
|
||
- Teste og distribuere egendefinerte MCP-servere i produksjonsmiljøer
|
||
- Lære praktisk arbeidsflytautomatisering for utviklere
|
||
|
||
---
|
||
|
||
<!-- CO-OP TRANSLATOR DISCLAIMER START -->
|
||
**Ansvarsfraskrivelse**:
|
||
Dette dokumentet er oversatt ved hjelp av AI-oversettelsestjenesten [Co-op Translator](https://github.com/Azure/co-op-translator). Selv om vi streber etter nøyaktighet, vær oppmerksom på at automatiske oversettelser kan inneholde feil eller unøyaktigheter. Det opprinnelige dokumentet på originalspråket skal betraktes som den autoritative kilden. For kritisk informasjon anbefales profesjonell menneskelig oversettelse. Vi er ikke ansvarlige for eventuelle misforståelser eller feiltolkninger som oppstår ved bruk av denne oversettelsen.
|
||
<!-- CO-OP TRANSLATOR DISCLAIMER END --> |