🔧 Modulul 3: Dezvoltare Avansată MCP cu AI Toolkit

🎯 Obiective de Învățare

La finalul acestui laborator, vei putea:

✅ Să creezi servere MCP personalizate folosind AI Toolkit
✅ Să configurezi și să folosești cea mai recentă versiune a MCP Python SDK (v1.9.3)
✅ Să configurezi și să utilizezi MCP Inspector pentru depanare
✅ Să depanezi servere MCP atât în Agent Builder, cât și în Inspector
✅ Să înțelegi fluxurile avansate de dezvoltare a serverelor MCP

📋 Cerințe Prealabile

Finalizarea Laboratorului 2 (Fundamente MCP)
VS Code cu extensia AI Toolkit instalată
Mediu Python 3.10+
Node.js și npm pentru configurarea Inspector

🏗️ Ce Vei Construi

În acest laborator, vei crea un Server MCP pentru Vreme care demonstrează:

Implementarea unui server MCP personalizat
Integrarea cu AI Toolkit Agent Builder
Fluxuri profesionale de depanare
Modele moderne de utilizare a MCP SDK

🔧 Prezentare Generală a Componentelor Cheie

🐍 MCP Python SDK

Model Context Protocol Python SDK oferă baza pentru construirea serverelor MCP personalizate. Vei folosi versiunea 1.9.3 cu capabilități îmbunătățite de depanare.

🔍 MCP Inspector

Un instrument puternic de depanare care oferă:

Monitorizare în timp real a serverului
Vizualizarea execuției uneltelor
Inspectarea cererilor și răspunsurilor de rețea
Mediu interactiv de testare

📖 Implementare Pas cu Pas

Pasul 1: Creează un WeatherAgent în Agent Builder

Deschide Agent Builder în VS Code prin extensia AI Toolkit
Creează un agent nou cu următoarea configurație:
- Nume agent: WeatherAgent

Pasul 2: Inițializează Proiectul Server MCP

Mergi la Tools → Add Tool în Agent Builder
Selectează "MCP Server" din opțiunile disponibile
Alege "Create A new MCP Server"
Selectează șablonul python-weather
Dă un nume serverului: weather_mcp

Pasul 3: Deschide și Examinează Proiectul

Deschide proiectul generat în VS Code

Revizuiește structura proiectului:

weather_mcp/
├── src/
│   ├── __init__.py
│   └── server.py
├── inspector/
│   ├── package.json
│   └── package-lock.json
├── .vscode/
│   ├── launch.json
│   └── tasks.json
├── pyproject.toml
└── README.md

Pasul 4: Actualizează la Cea Mai Recentă Versiune MCP SDK

🔍 De ce să actualizăm? Dorim să folosim cea mai nouă versiune MCP SDK (v1.9.3) și serviciul Inspector (0.14.0) pentru funcționalități îmbunătățite și o depanare mai bună.

4a. Actualizează Dependențele Python

Editează pyproject.toml: actualizează ./code/weather_mcp/pyproject.toml

4b. Actualizează Configurația Inspector

Editează inspector/package.json: actualizează ./code/weather_mcp/inspector/package.json

4c. Actualizează Dependențele Inspector

Editează inspector/package-lock.json: actualizează ./code/weather_mcp/inspector/package-lock.json

📝 Notă: Acest fișier conține definiții extinse ale dependențelor. Mai jos este structura esențială – conținutul complet asigură rezolvarea corectă a dependențelor.

⚡ Pachet Complet Lock: Fișierul complet package-lock.json conține aproximativ 3000 de linii cu definiții de dependențe. Mai sus este prezentată structura cheie – folosește fișierul furnizat pentru rezolvarea completă a dependențelor.

Pasul 5: Configurează Depanarea în VS Code

Notă: Te rugăm să copiezi fișierul în calea specificată pentru a înlocui fișierul local corespunzător

5a. Actualizează Configurația de Lansare

Editează .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
    }
  ]
}

Editează .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"
    }
  ]
}

🚀 Rularea și Testarea Serverului MCP

Pasul 6: Instalează Dependențele

După ce ai făcut modificările de configurare, rulează următoarele comenzi:

Instalează dependențele Python:

uv sync

Instalează dependențele Inspector:

cd inspector
npm install

Pasul 7: Depanare cu Agent Builder

Apasă F5 sau folosește configurația "Debug in Agent Builder"
Selectează configurația compusă din panoul de depanare
Așteaptă să pornească serverul și să se deschidă Agent Builder
Testează serverul tău MCP pentru vreme cu întrebări în limbaj natural

Introdu un prompt de genul acesta

SYSTEM_PROMPT

You are my weather assistant

USER_PROMPT

How's the weather like in Seattle

Pasul 8: Depanare cu MCP Inspector

Folosește configurația "Debug in Inspector" (Edge sau Chrome)
Deschide interfața Inspector la http://localhost:6274
Explorează mediul interactiv de testare:
- Vizualizează uneltele disponibile
- Testează execuția uneltelor
- Monitorizează cererile de rețea
- Depanează răspunsurile serverului

🎯 Rezultate Cheie ale Învățării

Prin finalizarea acestui laborator, ai:

Creat un server MCP personalizat folosind șabloanele AI Toolkit
Actualizat la cea mai recentă versiune MCP SDK (v1.9.3) pentru funcționalități îmbunătățite
Configurat fluxuri profesionale de depanare pentru Agent Builder și Inspector
Setat MCP Inspector pentru testare interactivă a serverului
Stăpânit configurările de depanare VS Code pentru dezvoltarea MCP

🔧 Funcționalități Avansate Explorate

Funcționalitate	Descriere	Caz de Utilizare
MCP Python SDK v1.9.3	Implementare protocol actuală	Dezvoltare modernă de server
MCP Inspector 0.14.0	Instrument interactiv de depanare	Testare server în timp real
Depanare VS Code	Mediu integrat de dezvoltare	Flux profesional de depanare
Integrare Agent Builder	Conexiune directă cu AI Toolkit	Testare completă a agenților

📚 Resurse Suplimentare

🎉 Felicitări! Ai finalizat cu succes Laboratorul 3 și acum poți crea, depana și implementa servere MCP personalizate folosind fluxuri profesionale de dezvoltare.

🔜 Continuă cu Modulul Următor

Ești gata să aplici abilitățile MCP într-un flux de lucru real? Continuă cu Modulul 4: Dezvoltare Practică MCP - Server Personalizat de Clonare GitHub unde vei:

Construi un server MCP pregătit pentru producție care automatizează operațiuni pe depozite GitHub
Implementa funcționalitatea de clonare a depozitelor GitHub prin MCP
Integra servere MCP personalizate cu VS Code și GitHub Copilot Agent Mode
Testa și implementa servere MCP personalizate în medii de producție
Învața automatizarea practică a fluxurilor de lucru pentru dezvoltatori

Declinare de responsabilitate:
Acest document a fost tradus folosind serviciul de traducere AI Co-op Translator. Deși ne străduim pentru acuratețe, vă rugăm să rețineți că traducerile automate pot conține erori sau inexactități. Documentul original în limba sa nativă trebuie considerat sursa autorizată. Pentru informații critice, se recomandă traducerea profesională realizată de un specialist uman. Nu ne asumăm răspunderea pentru eventualele neînțelegeri sau interpretări greșite rezultate din utilizarea acestei traduceri.

Provide feedback

Saved searches

Use saved searches to filter your results more quickly

🔧 Modulul 3: Dezvoltare Avansată MCP cu AI Toolkit

🎯 Obiective de Învățare

📋 Cerințe Prealabile

🏗️ Ce Vei Construi

🔧 Prezentare Generală a Componentelor Cheie

🐍 MCP Python SDK

🔍 MCP Inspector

📖 Implementare Pas cu Pas

Pasul 1: Creează un WeatherAgent în Agent Builder

Pasul 2: Inițializează Proiectul Server MCP

Pasul 3: Deschide și Examinează Proiectul

Pasul 4: Actualizează la Cea Mai Recentă Versiune MCP SDK

4a. Actualizează Dependențele Python

4b. Actualizează Configurația Inspector

4c. Actualizează Dependențele Inspector

Pasul 5: Configurează Depanarea în VS Code

5a. Actualizează Configurația de Lansare

🚀 Rularea și Testarea Serverului MCP

Pasul 6: Instalează Dependențele

Pasul 7: Depanare cu Agent Builder

Pasul 8: Depanare cu MCP Inspector

🎯 Rezultate Cheie ale Învățării

🔧 Funcționalități Avansate Explorate

📚 Resurse Suplimentare

🔜 Continuă cu Modulul Următor

FilesExpand file tree

README.md

Latest commit

History

README.md

File metadata and controls

🔧 Modulul 3: Dezvoltare Avansată MCP cu AI Toolkit

🎯 Obiective de Învățare

📋 Cerințe Prealabile

🏗️ Ce Vei Construi

🔧 Prezentare Generală a Componentelor Cheie

🐍 MCP Python SDK

🔍 MCP Inspector

📖 Implementare Pas cu Pas

Pasul 1: Creează un WeatherAgent în Agent Builder

Pasul 2: Inițializează Proiectul Server MCP

Pasul 3: Deschide și Examinează Proiectul

Pasul 4: Actualizează la Cea Mai Recentă Versiune MCP SDK

4a. Actualizează Dependențele Python

4b. Actualizează Configurația Inspector

4c. Actualizează Dependențele Inspector

Pasul 5: Configurează Depanarea în VS Code

5a. Actualizează Configurația de Lansare

🚀 Rularea și Testarea Serverului MCP

Pasul 6: Instalează Dependențele

Pasul 7: Depanare cu Agent Builder

Pasul 8: Depanare cu MCP Inspector

🎯 Rezultate Cheie ale Învățării

🔧 Funcționalități Avansate Explorate

📚 Resurse Suplimentare

🔜 Continuă cu Modulul Următor