wehub/microsoft--mcp-for-beginners

Fork 0

Files

T

History

wehub-resource-sync c275ba2868 chore: import upstream snapshot with attribution

2026-07-13 13:31:35 +08:00

code/weather_mcp

chore: import upstream snapshot with attribution

2026-07-13 13:31:35 +08:00

README.md

chore: import upstream snapshot with attribution

2026-07-13 13:31:35 +08:00

README.md

🔧 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

Start Agent Builder i VS Code via Microsoft Foundry Toolkit-utvidelsen
Lag en ny agent med følgende konfigurasjon:
- Agentnavn: WeatherAgent

Trinn 2: Initialiser MCP Server-prosjekt

Gå til Tools → Add Tool i Agent Builder
Velg "MCP Server" fra tilgjengelige alternativer
Velg "Create A new MCP Server"
Velg malen python-weather
Gi serveren navn: weather_mcp

Trinn 3: Åpne og undersøk prosjektet

Åpne det genererte prosjektet i VS Code

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

4b. Oppdater Inspector-konfigurasjon

Rediger inspector/package.json: oppdater ./code/weather_mcp/inspector/package.json

4c. Oppdater Inspector-avhengigheter

Rediger inspector/package-lock.json: oppdater ./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:

{
  "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:

uv sync

Installer Inspector-avhengigheter:

cd inspector
npm install

Trinn 7: Feilsøk med Agent Builder

Trykk F5 eller bruk "Debug in Agent Builder" konfigurasjonen
Velg sammensatt konfigurasjon fra feilsøkingspanelet
Vent på at serveren starter og at Agent Builder åpner
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

Bruk "Debug in Inspector" konfigurasjonen (Edge eller Chrome)
Åpne Inspector-grensesnittet på http://localhost:6274
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:

Opprettet en egendefinert MCP-server ved hjelp av Microsoft Foundry Toolkit-maler
Oppgradert til nyeste MCP SDK (v1.9.3) for bedre funksjonalitet
Konfigurert profesjonelle feilsøkingsarbeidsflyter for både Agent Builder og Inspector
Satt opp MCP Inspector for interaktiv servertesting
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

🎉 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 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

Ansvarsfraskrivelse: Dette dokumentet er oversatt ved hjelp av AI-oversettelsestjenesten 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.

README.md Unescape Escape

🔧 Modul 3: Avansert MCP-utvikling med Microsoft Foundry Toolkit

🎯 Læringsmål

📋 Forutsetninger

🏗️ Det du skal bygge

🔧 Oversikt over kjernekomponenter

🐍 MCP Python SDK

🔍 MCP Inspector

📖 Trinnvis implementering

Trinn 1: Opprett en WeatherAgent i Agent Builder

Trinn 2: Initialiser MCP Server-prosjekt

Trinn 3: Åpne og undersøk prosjektet

Trinn 4: Oppgrader til nyeste MCP SDK

4a. Oppdater Python-avhengigheter

4b. Oppdater Inspector-konfigurasjon

4c. Oppdater Inspector-avhengigheter

Trinn 5: Konfigurer VS Code feilsøking

5a. Oppdater lanseringskonfigurasjon

🚀 Kjøre og teste MCP-serveren din

Trinn 6: Installer avhengigheter

Trinn 7: Feilsøk med Agent Builder

Trinn 8: Feilsøk med MCP Inspector

🎯 Viktige læringsutbytter

🔧 Avanserte funksjoner som ble utforsket

📚 Ytterligere ressurser

🔜 Fortsett til neste modul

README.md