NFe/CTe Downloader

Aiteks · ferramentas para agentes

Seus XMLs exportados, consultados pelo seu agente

O Fiscal Local MCP conecta uma pasta escolhida por você a um cliente de IA compatível com MCP. Use os arquivos já baixados pelo NFe/CTe Downloader para listar documentos, conferir valores e montar resumos.

Baixar conector local · ZIPComo obter os XMLsDocumentação em texto

Versão 0.1.0 · Node.js >=22 · código e dependências declaradas no pacote

list_documents

Listar os XMLs

Localiza arquivos na pasta autorizada, com paginação.

inspect_document

Conferir um documento

Retorna tipo, número, chave, data de emissão e valor.

summarize_documents

Montar um resumo

Agrupa por documento, ambiente e mês, com filtros de período e resultado em JSON ou CSV.

Prepare a pasta e conecte o cliente

  1. Exporte os XMLs pela extensão. Extraia o ZIP para uma pasta exclusiva com os documentos que deseja consultar.
  2. Baixe e extraia o conector. No terminal, abra a pasta extraída e instale as dependências:
cd fiscal-local-mcp
npm ci

No cliente MCP de sua preferência, configure um servidor local por stdio. Use caminhos absolutos do seu computador:

comando: node
argumentos:
  /caminho/fiscal-local-mcp/src/server.mjs
  --root
  /caminho/meus-xmls

O README incluído traz a configuração completa. O cliente inicia o processo e se comunica pelo protocolo MCP; executar o servidor sozinho no terminal não abre uma interface.

Um primeiro pedido

“Liste os XMLs desta pasta. Depois, agrupe os documentos de produção por tipo e mês de emissão, mostrando os arquivos excluídos e os limites do resumo.”

Você também pode pedir o resultado em CSV. O conector devolve o texto ao cliente, sem gravar ou modificar arquivos.

Alcance e privacidade

  • Lê somente XMLs da pasta autorizada. Não acessa certificados, contas, ADN ou SEFAZ.
  • Não sincroniza a extensão, importa ZIP ou valida assinaturas fiscais.
  • Os totais descrevem os arquivos lidos; não calculam tributos devidos e não comprovam situação fiscal.
  • O servidor não faz chamadas de rede. O cliente de IA pode enviar os resultados ao provedor do modelo; confira a configuração e autorize somente os dados necessários.
Verificar o pacote baixado

Compare o SHA-256 do ZIP com o valor abaixo. O pacote contém o código, lockfile, instruções e testes, sem dependências instaladas ou dados de clientes.

1d78c92f29fe065203baf2dbd8ba6ae7ebdc5836d6f229e232c0e357fe2f82c0