MCP Travel Weather Server - LAB02

Dokumentasjon

Workshop Guide - Komplett workshop dokumentasjon
Presentasjon - Norsk workshop presentasjon

Workshop ressurser:

• Workshop Guide - Detaljert lab guide for workshop deltagere
• Presentasjon - Slide deck for workshop
• PowerPoint - PowerPoint versjon av presentasjon

Oversikt

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

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

Workshop Arkitektur (LAB02)

Forenklet tjenestearkitektur

┌─────────────────┐    HTTP    ┌─────────────────┐    HTTP    ┌─────────────────┐
│   Web Service   │ ─────────► │  Agent Service  │ ─────────► │  MCP Server     │
│   (Port 8080)   │            │   (Port 8001)   │            │   (Port 8000)   │
│                 │            │                 │            │                 │
│ • Frontend UI   │            │ • AI Logic      │            │ • Weather Tool  │
│ • User Interface│            │ • OpenAI GPT-4o │            │ • OpenWeatherMap│
│ • Examples      │            │ • Conversation  │            │ • Geocoding     │
│ • Health Checks │            │ • Memory        │            │ • Health Checks │
└─────────────────┘            └─────────────────┘            └─────────────────┘

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

HTTP API med dynamisk tools manifest - Port 8000

• GET /tools - MCP tools manifest (følger MCP spesifikasjon)
• POST /weather - Værprognose for destinasjoner
• GET /health - Helsesjekk

MCP Tools Manifest: Serveren eksponerer tilgjengelige verktøy via /tools endepunkt i henhold til MCP spesifikasjonen, inkludert navn, beskrivelse, input schema og endpoint informasjon.

API som brukes:

• OpenWeatherMap for værdata
• Nominatim (OpenStreetMap) for geocoding

2. Agent Service (services/agent/)

AI-orkestrering med dynamisk tools loading - Port 8001

• OpenAI GPT-4o mini for intelligent respons
• Dynamisk lasting av verktøy fra MCP server ved oppstart
• HTTP klient med intelligent endpoint mapping
• Persistent SQLite database for samtalehistorikk
• Eksplisitt og konvensjonsbasert endpoint mapping
• POST /query - Prosesser brukerforespørsler
• GET /health - Helsesjekk med agent status

3. Web Service (services/web/)

Frontend web-grensesnitt - Port 8080

• HTML/JavaScript grensesnitt
• HTTP klient for agent kommunikasjon
• Eksempel spørsmål og interaktiv chat
• Real-time helsestatusindikator
• GET / - Hovedside