UNHCR Open Data Gateway MCP

Una puerta de enlace basada en FastMCP que agrega y normaliza datos de los servidores MCP específicos de dominio de UNHCR.

🎯 Propósito

El UNHCR Open Data Gateway MCP proporciona una interfaz unificada para acceder a los datos abiertos de UNHCR a través de tres servidores MCP independientes:

• Statistics MCP: Fuente autorizada para datos de población y desplazamiento

• RDF MCP: Fuente autorizada para indicadores socioeconómicos y conjuntos de datos contextuales

• IATI MCP: Fuente autorizada para datos de presupuesto, contribuciones y transparencia financiera

Related MCP server: data-bs-mcp

🏗️ Arquitectura

La puerta de enlace sigue un Patrón de puerta de enlace federada:

                    AI Client
                         |
                         v

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

                 /      |      \

                /       |       \

               v        v        v

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

                   ^
                   |
                   |
          Reference Layer
          (Canonical Entities)

Principios fundamentales

1. Propiedad del MCP de dominio: Cada MCP de dominio posee sus datos

2. La puerta de enlace posee la experiencia: La puerta de enlace maneja agregación, composición, descubrimiento y análisis

3. Independencia del MCP de dominio: Los MCP de dominio nunca se llaman entre sí directamente

4. Capa de referencia canónica: Evita la duplicación de definiciones de país/operación

🚀 Inicio rápido

Instalación

# 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

Configuración

Crea un archivo .env:

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

Ejecutar el servidor

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

🛠️ Uso

Herramientas disponibles

Consultas de ejemplo

# 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)

📊 Características

• Normalización de países: Maneja variantes de ISO3, ISO2, nombres, alias, "República de X"

• Analítica entre dominios: Brecha de financiación por refugiado, presupuesto por refugiado, etc.

• Degradación elegante: Devuelve datos parciales cuando algunos MCP no están disponibles

• Caché: Caché basada en TTL con expiración configurable

• Observabilidad: Registro estructurado, métricas, trazado de OpenTelemetry

📄 Licencia

Apache License 2.0

🙏 Soporte

Para problemas o preguntas, por favor contacta al equipo de datos de UNHCR.