한국어 | Korean

ISTAT SDMX API에서 이탈리아 통계 데이터를 액세스하기위한 MCP 서버.

개요

이 모델 Context Protocol (MCP) 서버는 SDMX REST API를 통해 ISTAT (Istituto Nazionale di Statistica)의 이탈리아 통계 데이터에 액세스하는 Claude Desktop을 제공합니다. API 호출을 최소화하는 두 층 캐싱 메커니즘을 구현하고 발견, 쿼리 및 통계 데이터를 검색하기위한 8 도구를 제공합니다.

특징

• 8 MCP Tools 데이터 검색 및 검색:
• discover_dataflows - 키워드로 사용 가능한 데이터셋 찾기 (blacklist filtering)
• get_structure - 데이터 구조 ID에 대한 치수 정의 및 코드 목록을 가져옵니다
• get_constraints - 설명과 각 차원에 대한 사용 가능한 제약 값을 가져옵니다 (구축 구조 + 제약 + 코드 목록 설명; 동일한 출력은 istat-get-constraints-cli] 명령에서 사용할 수 있으며, SKILL.md 참조)
• get_codelist_description - codelist 값에 대한 이탈리아/영어에 대한 설명 얻기
• get_concepts - ID로 ISTAT 개념의 이탈리아어 또는 영어 설명을 가져옵니다 ([T6]]] 명령)

ISTAT MCP Server

English | Italiano

MCP server for accessing Italian statistical data from the ISTAT SDMX API.

Overview

This Model Context Protocol (MCP) server provides Claude Desktop with access to Italian statistical data from ISTAT (Istituto Nazionale di Statistica) through the SDMX REST API. It implements a two-layer caching mechanism to minimize API calls and provides eight tools for discovering, querying, and retrieving statistical data.

Features

• 8 MCP Tools for data discovery and retrieval:

  • discover_dataflows - Find available datasets by keywords (with blacklist filtering)
  • get_structure - Get dimension definitions and codelists for a datastructure ID
  • get_constraints - Get available constraint values for each dimension with descriptions (combines structure + constraints + codelist descriptions; the same output is available from the istat-get-constraints-cli command, see SKILL.md)
  • get_codelist_description - Get descriptions in Italian/English for codelist values
  • get_concepts - Get the Italian or English description of an ISTAT concept by ID (wraps the istat-get-concepts-cli command)
  • get_data - Fetch actual statistical data in TSV table format (with blacklist validation)
  • get_cache_diagnostics - Debug tool to inspect cache status
  • get_territorial_codes - Resolve ISTAT REF_AREA codes for Italia, ripartizioni, regioni, province, and comuni

• Recommended Workflow (simple and efficient):

  1. Discover: Use discover_dataflows to find the dataflow you’re interested in
  2. Get Complete Metadata: Use get_constraints to see all dimensions with valid values AND descriptions in one call
     • This is the RECOMMENDED approach - one call instead of many
     • Internally combines get_structure + get_codelist_description for all dimensions
     • All data cached for 1 month → subsequent calls are instant
     • Returns complete information ready for building filters in get_data
  3. Fetch Data: Use get_data with the appropriate dimension filters to retrieve actual data

  Alternative workflow (manual approach):

  • Use get_structure with a datastructure ID to see dimensions and their codelists
  • Then call get_codelist_description manually for each codelist you need
  • Use get_concepts to get the Italian or English description of a specific concept ID (e.g. a dimension name)

• Two-Layer Cache:

  • In-memory cache (cachetools) for fast access during session
  • Persistent disk cache (diskcache) that survives restarts

• Rate Limiting: Maximum 4 API calls per minute with automatic queuing

• Retry Logic: Exponential backoff on transient errors