AI导哈

电子发票查询服务

MCP Server用于通过IntegraDTE API查询智利电子发票数据，允许语言模型（如Claude）通过MCP协议查询税务文档、票据、统计等信息。

  • by JoseLuis21
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 JoseLuis21/full-dte-mcp

使用说明

@integradte/mcp

MCP Server para consultar datos de facturación electrónica chilena desde la API IntegraDTE.

Permite a modelos de lenguaje (Claude, etc.) consultar documentos tributarios, folios, estadísticas y más mediante el protocolo MCP (Model Context Protocol).

Tools disponibles

Tool Descripción
get_user_info Info del usuario autenticado (nombre, email, estado)
get_certificate_info Estado del certificado digital (vencimiento, titular)
list_documents Listar DTEs con filtros (tipo, estado, fechas, paginación)
get_document Detalle de un documento por ID
get_document_stats Estadísticas: totales emitidos, montos, por tipo DTE
get_numeration_summary Resumen de folios disponibles por tipo
get_last_folio Último folio usado para un tipo de DTE

Instalación

npm install
npm run build

Variables de entorno

Variable Descripción Default
API_BASE_URL URL de la API IntegraDTE http://localhost:5058
API_KEY API Key de autenticación (requerida) —

Uso con Claude Desktop

Agregar a claude_desktop_config.json:

{
  "mcpServers": {
    "integradte": {
      "command": "npx",
      "args": ["-y", "@integradte/mcp"],
      "env": {
        "API_BASE_URL": "https://api.integradte.cl",
        "API_KEY": "tu_api_key"
      }
    }
  }
}

Uso con npx (una vez publicado)

{
  "mcpServers": {
    "integradte": {
      "command": "npx",
      "args": ["-y", "@integradte/mcp"],
      "env": {
        "API_BASE_URL": "https://api.integradte.cl",
        "API_KEY": "tu_api_key"
      }
    }
  }
}

Tipos de DTE soportados

Código Tipo
33 Factura Electrónica
34 Factura Exenta
39 Boleta Electrónica
41 Boleta Exenta
46 Factura de Compra
52 Guía de Despacho
56 Nota de Débito
61 Nota de Crédito

Desarrollo

npm install
npm run dev    # Watch mode
npm run build  # Build
npm start      # Run

Publicación a npm con versiones automáticas

Este repo usa Changesets + GitHub Actions.

Configuración inicial

  1. Crear el secret NPM_TOKEN en GitHub (Settings > Secrets and variables > Actions).
  2. El token debe tener permisos para publicar en el scope @integradte.
  3. Si la organización exige 2FA para publish, usa un token con bypass 2fa.

Flujo de versiones

  1. Para cada cambio que quieras versionar, crea un changeset:
    pnpm changeset
  2. Haz commit del archivo en .changeset/*.md junto a tu cambio.
  3. Al hacer merge a main, el workflow Release crea/actualiza un PR de release con el nuevo versionado.
  4. Cuando ese PR se mergea, el mismo workflow publica automáticamente a npm.

相关 MCP