mcp-nfs-emissor

Servidor MCP (Desktop Extension .mcpb) que emite NFS-e de comissão de afiliado da Shopee a partir do CSV mensal. Roda 100% local via stdio — o CSV, o certificado A1 e a emissão nunca saem da máquina.

Estado atual: scaffold. Estrutura, configs, servidor MCP e testes estão de pé; a tool listar_saidas é funcional e as outras 6 são stubs (isError). A lógica de negócio (parse/agregação/emissão) e os providers reais chegam nas próximas fases — ver docs/plugin-claude-mvp/.

Requisitos

• Node.js >= 18 (testado no 24)

• pnpm

Related MCP server: mcp-nfe-br

Scripts

pnpm install       # instala dependências
pnpm dev           # roda o servidor em dev (tsx), stdio
pnpm build         # compila para dist/ (entry_point do .mcpb = dist/server.js)
pnpm typecheck     # checagem de tipos sem emitir
pnpm test          # testes de integração (vitest, transporte in-memory)

Tools (catálogo — fase-2 §5)

Documentação

• Fonte de verdade do plugin: docs/plugin-claude-mvp/ (fases 1–4 + decisões).

• Plano do scaffold: docs/emissores-nf/plan-scaffold-mcp-01.md.

• Contexto fiscal e mapeamento do CSV: docs/emissores-nf/.

Segurança

Segredos (token do provedor, senha do .pfx) chegam por user_config → env, guardados no Keychain/Credential Manager do SO. O .pfx fica fora do bundle (referenciado por caminho). Nada de segredo é versionado — ver .gitignore e .env.example.

Licença

MIT