Skip to main content
Glama
Edouard-Legoupil

UNHCR Open Data Gateway MCP

UNHCR Open Data Gateway MCP

UNHCR의 도메인별 MCP 서버에서 데이터를 집계하고 정규화하는 FastMCP 기반 게이트웨이입니다.

🎯 목적

UNHCR Open Data Gateway MCP는 세 개의 독립적인 MCP 서버에서 UNHCR의 공개 데이터에 접근할 수 있는 통합 인터페이스를 제공합니다:

  • Statistics MCP: 인구 및 이재민 데이터의 권위 있는 소스

  • RDF MCP: 사회경제적 지표 및 상황별 데이터셋의 권위 있는 소스

  • IATI MCP: 예산, 기여금 및 재정 투명성 데이터의 권위 있는 소스

Related MCP server: data-bs-mcp

🏗️ 아키텍처

게이트웨이는 연합 게이트웨이 패턴(Federated Gateway Pattern) 을 따릅니다:

                    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

🛠️ 사용법

사용 가능한 도구

도구

설명

매개변수

country_snapshot

국가에 대한 종합 스냅샷

country, year

operation_snapshot

운영에 대한 종합 스냅샷

operation, year

funding_gap_analysis

자금 격차 및 난민당 지표 계산

country, year

funding_per_refugee

난민당 자금 지표 계산

country, year

compare_countries

모든 도메인에서 두 국가 비교

country_a, country_b, year

search_datasets

모든 MCP에서 데이터셋 검색

query, country, region, topic, dataset

list_all_datasets

사용 가능한 모든 데이터셋 나열

-

generate_country_brief

종합 브리핑 노트 생성

country, year

예시 쿼리

# 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, 이름, 별칭, "Republic of X" 변형 처리

  • 도메인 간 분석: 난민당 자금 격차, 난민당 예산 등

  • 우아한 성능 저하: 일부 MCP를 사용할 수 없을 때 부분 데이터 반환

  • 캐싱: 구성 가능한 만료 시간을 가진 TTL 기반 캐싱

  • 관찰 가능성: 구조화된 로깅, 메트릭, OpenTelemetry 추적

📄 라이선스

Apache License 2.0

🙏 지원

문제나 질문이 있으면 UNHCR 데이터 팀에 문의하세요.

A
license - permissive license
Not graded
quality - not tested
B
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • F
    license
    A
    quality
    C
    maintenance
    MCP server for querying Huwise/Opendatasoft data portals. Enables dataset search, metadata retrieval, record filtering with ODSQL, and data export.
    5
    2
  • A
    license
    Not graded
    quality
    D
    maintenance
    Unified MCP server for discovering open datasets across Hugging Face, Zenodo, and Kaggle, with ranked search results and one-click Colab starter code generation.
    1
    MIT
  • A
    license
    A
    quality
    B
    maintenance
    Unifies 24 Dutch public-sector data sources into a single MCP interface, enabling AI assistants to search, combine, and retrieve structured data with provenance and cross-source linking.
    64
    11
    Apache 2.0

View all related MCP servers

Related MCP Connectors

  • This MCP server provides seamless access to Malaysia's government open data, including datasets, w…

  • Search and query 1,500+ OECD statistical datasets via SDMX. Keyless.

  • HealthData.gov MCP — wraps HealthData.gov CKAN API (free, no auth)

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Edouard-Legoupil/unhcr-opendata-gateway-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server