appsperu — monorepo de Rastro

El Estado peruano deja más datos abiertos de los que nadie está usando. Nosotros los estamos conectando.

Repo: https://github.com/Treevu-ai/appsperu

Monorepo que conecta datos abiertos del Estado peruano — presupuesto, contrataciones, inversiones, obras públicas, catastro minero, títulos forestales, transporte, infraestructura, supervisión ambiental, macro BCRP (tipo de cambio, inflación, PBI, tasas de interés) — en un pipeline de ingestión manual con conectores estándar y rate limits respetuosos.

Arquitectura actual

Agentes IA (Claude Code, Cursor, Claude Desktop)
    → MCP Worker (Cloudflare Workers — rastro.fyi/mcp)
        → Neon: 1 proyecto Postgres, 36 bases (una por app)
                ↑
    Scripts de ingestión (locales, on-demand → Neon con pg)

• MCP Server (mcp-server/): Worker de Cloudflare que expone 209 tools de solo lectura vía 3 meta-tools (rastro_buscar_tools + rastro_llamar + rastro_health).
• Data layer: Neon (Postgres 17 serverless) — un proyecto, 36 bases, un rol. Se eligió Neon sobre D1: D1 no tiene PostGIS, ni transacciones, ni advisory locks, y el repo los usa. Ver docs/adr/0024-neon-en-lugar-de-d1.md.
• Ingreso de datos: scripts locales (apps//api/src/ingest/*) que corren a demanda y escriben a Neon con pg de siempre. No cambian.
• Provisioning: mcp-server/RUNBOOK_NEON.md.

Apps

Uso del MCP Server (Worker)

Desarrollo local (stdio)

cd mcp-server
npm ci
npm run dev          # transporte stdio — para usar desde Claude Code/Cursor local

Configura el cliente MCP (.mcp.json o ~/.cursor/mcp.json):

{
  "mcpServers": {
    "rastro": {
      "command": "node",
      "args": ["mcp-server/dist/index.js"]
    }
  }
}

Producción (Cloudflare Worker)

El MCP server está desplegado como un Worker de Cloudflare en https://rastro.fyi/mcp (Streamable HTTP, autenticado con API key x-api-key).

El secret NEON_DATABASE_URL apunta a una base cualquiera del proyecto; el resolver reescribe el nombre por app. Ver mcp-server/src/db/neon-env.ts y el runbook de provisioning.

Ingesta de datos (on-demand)

Todo es manual — no hay scheduler. Cada conector es un script CLI:

# Ingesta completa para La Libertad (MEF + Invierte + INFOBRAS + OECE + ObservaPerú + BCRP)
bash scripts/ingest-la-libertad-completo.sh

# Ingesta individual por app
cd apps//api
npm run dev          # inicia server local
# en otra terminal:
npm run ingest:*      # según los scripts que declare cada app

Ver docs/conectores.md — ficha técnica por conector.

Documentación

• docs/ESTADO.md — estado actual, historial de trabajo, pendientes.
• docs/conectores.md — qué hace cada conector, cómo, fuente y frecuencia.
• docs/data-contracts/ — un archivo por fuente externa.
• docs/adr/ — decisiones arquitectónicas.
• mcp-server/README.md — arquitectura interna del servidor MCP.