UNHCR Open Data Gateway MCP

Шлюз на основе FastMCP, который агрегирует и нормализует данные с доменных MCP-серверов UNHCR.

🎯 Назначение

UNHCR Open Data Gateway MCP предоставляет единый интерфейс для доступа к открытым данным UNHCR через три независимых MCP-сервера:

• Statistics MCP: Авторитетный источник данных о населении и перемещениях

• RDF MCP: Авторитетный источник социально-экономических показателей и контекстных наборов данных

• IATI MCP: Авторитетный источник данных о бюджете, взносах и финансовой прозрачности

Related MCP server: dataset-search-mcp

🏗️ Архитектура

Шлюз следует шаблону федеративного шлюза:

                    AI Client
                         |
                         v

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

                 /      |      \

                /       |       \

               v        v        v

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

                   ^
                   |
                   |
          Reference Layer
          (Canonical Entities)

Основные принципы

1. Владение доменными MCP: Каждый доменный MCP владеет своими данными

2. Шлюз владеет опытом: Шлюз обрабатывает агрегацию, композицию, обнаружение, аналитику

3. Независимость доменных MCP: Доменные MCP никогда не вызывают друг друга напрямую

4. Канонический справочный слой: Предотвращает дублирование определений стран/операций

🚀 Быстрый старт

Установка

# 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

Конфигурация

Создайте файл .env:

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

Запуск сервера

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

🛠️ Использование

Доступные инструменты

Примеры запросов

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

📊 Возможности

• Нормализация стран: Обрабатывает ISO3, ISO2, названия, псевдонимы, варианты типа "Республика X"

• Междоменная аналитика: Дефицит финансирования на беженца, бюджет на беженца и т.д.

• Плавная деградация: Возвращает частичные данные, когда некоторые MCP недоступны

• Кэширование: Кэширование на основе TTL с настраиваемым сроком действия

• Наблюдаемость: Структурированное журналирование, метрики, трассировка OpenTelemetry

📄 Лицензия

Apache License 2.0

🙏 Поддержка

По вопросам или проблемам обращайтесь в команду данных UNHCR.