UNHCR Open Data Gateway MCP

Ein FastMCP-basiertes Gateway, das Daten von den domänenspezifischen MCP-Servern des UNHCR aggregiert und normalisiert.

🎯 Zweck

Das UNHCR Open Data Gateway MCP bietet eine einheitliche Schnittstelle für den Zugriff auf die offenen Daten des UNHCR über drei unabhängige MCP-Server:

• Statistics MCP: Autoritative Quelle für Bevölkerungs- und Vertreibungsdaten

• RDF MCP: Autoritative Quelle für sozioökonomische Indikatoren und kontextuelle Datensätze

• IATI MCP: Autoritative Quelle für Budget-, Beitrags- und Finanztransparenzdaten

Related MCP server: data-bs-mcp

🏗️ Architektur

Das Gateway folgt einem Föderierten Gateway-Muster:

                    AI Client
                         |
                         v

            +----------------------+
            |  Open Data Gateway   |
            |       FastMCP        |
            +----------------------+

                 /      |      \

                /       |       \

               v        v        v

        +---------+ +---------+ +---------+
        | Stat    | | RDF     | | IATI    |
        | MCP     | | MCP     | | MCP     |
        +---------+ +---------+ +---------+

                   ^
                   |
                   |
          Reference Layer
          (Canonical Entities)

Kernprinzipien

1. Domain-MCP-Eigentum: Jedes Domain-MCP besitzt seine Daten

2. Gateway besitzt die Erfahrung: Das Gateway übernimmt Aggregation, Komposition, Entdeckung und Analytik

3. Domain-MCP-Unabhängigkeit: Domain-MCPs rufen sich nie direkt gegenseitig auf

4. Kanonische Referenzschicht: Verhindert Duplikation von Länder-/Operationsdefinitionen

🚀 Schnellstart

Installation

# Clone the repository
git clone <repository-url>
cd unhcr-opendata-gateway-mcp

# Create virtual environment
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

Konfiguration

Erstellen Sie eine .env-Datei:

STAT_MCP_ENDPOINT=http://localhost:8001
RDF_MCP_ENDPOINT=http://localhost:8002
IATI_MCP_ENDPOINT=http://localhost:8003
LOG_LEVEL=INFO

Server starten

# Run in STDIO mode
python -m src.unhcr_opendata_gateway.app

🛠️ Verwendung

Verfügbare Tools

Beispielabfragen

# Get a country snapshot
result = await country_snapshot(country="Uganda", year=2023)

# Calculate funding gap
result = await funding_gap_analysis(country="Chad", year=2023)

# Compare two countries
result = await compare_countries(country_a="Uganda", country_b="Kenya", year=2023)

# Generate a briefing note
result = await generate_country_brief(country="Sudan", year=2023)

📊 Funktionen

• Ländernormalisierung: Behandelt ISO3, ISO2, Namen, Aliase, „Republik X“-Varianten

• Domänenübergreifende Analytik: Finanzierungslücke pro Flüchtling, Budget pro Flüchtling usw.

• Sanfte Degradierung: Gibt partielle Daten zurück, wenn einige MCPs nicht verfügbar sind

• Caching: TTL-basiertes Caching mit konfigurierbarem Ablauf

• Beobachtbarkeit: Strukturierte Protokollierung, Metriken, OpenTelemetry-Tracing

📄 Lizenz

Apache License 2.0

🙏 Unterstützung

Bei Problemen oder Fragen wenden Sie sich bitte an das UNHCR-Datenteam.