Sunat Datos Abiertos

БесплатноНе проверен

MCP server that exposes SUNAT Peruvian tax agency datasets (RUC registry, electronic receipts, IGV agents) via CKAN API with streaming preview and automatic zip

автор: AnderMC66

GitHub Embed

Описание

MCP server that exposes SUNAT Peruvian tax agency datasets (RUC registry, electronic receipts, IGV agents) via CKAN API with streaming preview and automatic zip decompression.

README

Servidor MCP (Model Context Protocol) que expone los datasets de SUNAT publicados en la Plataforma Nacional de Datos Abiertos del Perú (padrón RUC con clasificación de actividad económica CIIU, comprobantes de pago electrónicos, agentes de retención/percepción de IGV, etc.).

Requisitos

Node.js 18+

Instalación

npm install
npm run build

Tools disponibles

Tool	Descripción
`sunat_listar_datasets`	Lista los datasets de SUNAT disponibles (slug, título, cantidad de recursos).
`sunat_obtener_dataset`	Detalle y lista de recursos de un dataset dado su slug.
`sunat_obtener_recurso`	Metadata y URL real de descarga de un recurso dado su id.
`sunat_previsualizar_recurso`	Previsualiza las primeras filas de un recurso (csv suelto o csv dentro de zip) sin descargarlo completo.

Flujo típico: sunat_listar_datasets → sunat_obtener_dataset (con el dataset elegido) → sunat_previsualizar_recurso (con el id del recurso elegido).

Nota sobre el portal

La API de este portal es CKAN, pero con dos particularidades verificadas contra la API real:

package_search y organization_list están deshabilitados (devuelven 404); por eso este servidor navega por el grupo de SUNAT (group_package_show) en vez de buscar por palabra clave.
package_show y group_package_show envuelven su resultado en un array adicional de un solo elemento, a diferencia de package_list/resource_show. El servidor ya lo maneja.
El campo formato de un recurso no siempre es confiable: varios recursos declarados como csv son en realidad un .zip que contiene el csv adentro. sunat_previsualizar_recurso detecta esto y descomprime en streaming, cortando la descarga apenas junta las filas pedidas.

Uso con Claude Desktop / Claude Code

Agrega en tu configuración de servidores MCP (claude_desktop_config.json o equivalente):

{
  "mcpServers": {
    "sunat-datos-abiertos": {
      "command": "node",
      "args": ["C:\\source\\mcp-'nodefinido'\\build\\index.js"]
    }
  }
}

Desarrollo

npm run build   # compila TypeScript a build/
npm start       # corre el servidor compilado

from github.com/AnderMC66/mcp-sunat

Установить Sunat Datos Abiertos в Claude Desktop, Claude Code, Cursor

Рекомендуется · одна команда, все IDE

unyly install sunat-datos-abiertos-mcp

Ставит в Claude Desktop, Claude Code, Cursor и VS Code — сам разбирается с npx, uvx и сборкой из исходников.

Впервые? Поставь CLI: curl -fsSL https://unyly.org/install | sh

Или настроить вручную

Выполни в терминале:

claude mcp add sunat-datos-abiertos-mcp -- npx -y github:AnderMC66/mcp-sunat

FAQ