西班牙国家统计局数据服务

一个提供西班牙国家统计局(INE)完整JSON API的MCP服务器,允许LLM助手发现、探索和检索西班牙官方统计数据。

  • by dcerecedo
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 dcerecedo/ine-mcp

使用说明

INE MCP服务器

一 主控程序 公开完整信息的服务器 西班牙国家统计局(INE) JSON API, 允许法学硕士助理发现、探索和检索官方西班牙语 统计数据。

数据层次结构

Operations  (statistical domains — IPC, EPA, Censo…)
  └── Tables  (pre-built cross-tabulations)
        ├── Groups / Values  (filter dimensions + their options)
        └── Series  (individual time series)
              └── Data points  (observations over time)

工具

工具 说明
list_operations 发现所有统计领域
get_operation 一次操作的完整元数据
list_tables 操作表
get_table_structure 表的组和可过滤值
get_table_data 主要数据工具 --使用可选筛选器检索行
get_series_data 对单个命名系列的观察
search_operation_data 通过元数据过滤器进行跨操作查询
get_series_metadata 系列的完整元数据
list_series_in_table 表中的所有系列代码
get_operation_variables 操作的变量(维度)
get_variable_values 变量的允许值
list_publications 操作的发布日历

资源

URI 描述
ine://operations 完整的操作目录
ine://operation/{code} 操作详情+表格列表
ine://table/{id}/structure 表过滤器结构

提示

提示 描述
explore_topic 逐步计划查找任何主题的数据
get_latest_indicator 检索指标的最新发布值

设置

1.创建虚拟环境

python3 -m venv .venv
source .venv/bin/activate  # on Windows: .venv\Scripts\activate

2.安装依赖项

安装包含所有开发依赖项的软件包:

pip install -e ".[dev]"

3.运行测试

pytest

4.运行服务器

stdio传输 (默认值,适用于MCP客户端):

ine-mcp

SSE运输 (HTTP,端口8000):

MCP_TRANSPORT=sse ine-mcp

5.MCP客户端配置

添加到MCP客户端配置中:

{
  "mcpServers": {
    "ine": {
      "command": "ine-mcp"
    }
  }
}

码头工人

塑造形象

docker build -t ine-mcp .

使用Docker运行

docker run -p 8000:8000 ine-mcp

使用Docker Compose运行

docker compose up

要在后台运行,请执行以下操作:

docker compose up -d

服务器将在以下时间可用 http://localhost:8000.

API 参考