MCP Travel Weather Server - LAB03

Dokumentasjon

Presentasjon - Marp presentation markdown

Oversikt

MCP Travel Weather Server er en basis-implementasjon for MCP workshop LAB03. Dette er en læringsorientert versjon som demonstrerer Model Context Protocol (MCP) grunnleggende konsepter med fokus på værdata.

Arkitektur: Systemet består av tre hovedkomponenter:

• Web Service: Frontend brukergrensesnitt
• AI Agent: OpenAI-basert agent som orkestrerer forespørsler
• MCP Server: HTTP API med værfunksjonalitet

✅ MCP 2025-11-25 Kompatibel Implementasjon

Denne workshopen implementerer JSON-RPC 2.0 over HTTP i henhold til den offisielle MCP spesifikasjonen (2025-11-25).

Offisielle MCP 2025-11-25 Transporter:

1. stdio - JSON-RPC 2.0 over standard input/output
2. Streamable HTTP - JSON-RPC 2.0 over HTTP POST med valgfri Server-Sent Events (SSE)

Vår Implementasjon:

• ✅ JSON-RPC 2.0 protokoll
• ✅ POST /message endpoint for alle operasjoner
• ✅ tools/list metode for verktøyoppdagelse
• ✅ tools/call metode for verktøykjøring
• ✅ Standard JSON-RPC feilkoder
• ✅ MCP-compliant tool result format (content, structuredContent, isError)
• ✅ MCP tools manifest struktur

Hvorfor Denne Tilnærmingen?

• ✅ Spec-kompatibel og produksjonsklar
• ✅ Lærer den faktiske MCP-protokollen
• ✅ Enkelt å teste med curl (bare JSON)
• ✅ Ingen migrering nødvendig for produksjon
• ✅ Tydelig protokollstruktur

Hva Som Er Valgfritt (Ikke Implementert):

• ⚪ stdio transport (kun HTTP i denne workshopen)
• ⚪ Server-Sent Events streaming
• ⚪ WebSocket transport
• ⚪ MCP SDK wrappere (bruker direkte JSON-RPC for læring)

Dette er en produksjonsklar implementasjon som følger MCP-spesifikasjonen fullstendig.

Workshop Arkitektur (LAB03)

Forenklet tjenestearkitektur

graph LR
    A["Web ServicePort 8080━━━━━━━━━• Frontend UI• User Interface• Examples• Health Checks"] --HTTP--> B["Agent ServicePort 8001━━━━━━━━━• AI Logic• OpenAI GPT-4o• Conversation• Memory"]
    B --HTTP--> C["MCP ServerPort 8000━━━━━━━━━• Weather Tool• OpenWeatherMap• Geocoding• Health Checks"]
    
    style A fill:#e1f5ff,stroke:#01579b,stroke-width:2px,color:#000
    style B fill:#f3e5f5,stroke:#4a148c,stroke-width:2px,color:#000
    style C fill:#e8f5e9,stroke:#1b5e20,stroke-width:2px,color:#000

1. MCP Server (services/mcp-server/)

MCP-compliant JSON-RPC 2.0 API - Port 8000

• POST /message - JSON-RPC 2.0 endpoint for alle operasjoner
  • tools/list metode - Hent verktøymanifest
  • tools/call metode - Kjør verktøy
• GET /health - Helsesjekk

MCP Tools Manifest: Serveren følger MCP spesifikasjonen og eksponerer verktøy med:

• name: Unikt verktøynavn
• title: Human-readable visningsnavn