MCP.so
ログイン

MCP NFSe Nacional

@SamuelMoraesF

リポジトリ

MCP NFSe Nacional について

🇧🇷 MCP Server para consultar NFSe no portal nacional (nfse.gov.br). Busque notas, baixe XMLs e PDFs direto do seu AI agent.

#brazil#gov-br#nfse#nfse-nacional#nfe

基本情報

カテゴリ

その他

ランタイム

node

トランスポート

stdio

公開者

SamuelMoraesF

投稿者

Samuel Moraes

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

{
  "mcpServers": {
    "nfse-nacional": {
      "command": "npx",
      "args": [
        "-y",
        "samuelmoraesf/mcp-nfse-nacional"
      ],
      "env": {
        "CERT_PASSWORD": "sua_senha_do_certificado",
        "CERT_FILE": "caminho/para/seu/certificado.pfx",
        "NODE_OPTIONS": "--openssl-legacy-provider"
      }
    }
  }
}

ツール

ツールは検出されませんでした

ツールは README から自動的に抽出されます。メンテナーは ## Tools という見出しの下に記載することで、このタブに反映できます。

概要

What is MCP NFSe Nacional?

MCP NFSe Nacional is an MCP (Model Context Protocol) server that enables AI agents to authenticate with an e-CNPJ/e-CPF digital certificate and consult, retrieve details, and download PDFs of Brazilian Electronic Service Invoices (NFSe) from the national portal (nfse.gov.br).

How to use MCP NFSe Nacional?

Install and run via npx with the required environment variables CERT_FILE (path to .pfx/.p12 certificate) and CERT_PASSWORD. Optionally configure MCP_TRANSPORT (stdio or streamable-http) and STORAGE_PATH. The server exposes three tools: nfse_buscar, nfse_detalhes, and nfse_pdf. Docker images are also provided for the streamable-http mode.

Key features of MCP NFSe Nacional

  • Three tools: list invoices, get details, download PDFs.
  • Automatic authentication with digital certificate.
  • Transparent session renewal on authentication errors.
  • Supports stdio and streamable-http transport modes.
  • Docker image for production deployment.
  • Configurable local storage for downloaded XMLs and PDFs.

Use cases of MCP NFSe Nacional

  • AI agents retrieving NFSe data for a given date range.
  • Automating the download of DANFSe PDFs from the national portal.
  • Integrating invoice details into tax compliance workflows.
  • Providing LLM-based assistants with access to real fiscal documents.

FAQ from MCP NFSe Nacional

What authentication is required?

The server requires a digital certificate file (.pfx or .p12) and its password. Authentication is handled automatically; if the session expires, the server re-authenticates transparently.

What runtime or dependencies are needed?

The server is a Node.js application run via npx. No additional runtime dependencies beyond Node.js are required. For Docker, a pre-built image is available.

Where are downloaded files stored?

XMLs and PDFs are saved locally in the directory specified by STORAGE_PATH (defaults to ./storage). The path can be customized via environment variable.

Which transport modes are supported?

Two modes: stdio (default, for direct client integration like Claude Desktop or VS Code) and streamable-http (for HTTP-based servers). In HTTP mode, bind address and port are configurable.

What security precautions should I take?

The certificate is a critical asset; never version it in Git, restrict file permissions, use environment variables for the password, and do not expose the HTTP server publicly without authentication. Mount the certificate as read-only in Docker.

コメント

「その他」の他のコンテンツ

Production-ready MCP integrations for AI applications

Klavis-AI

Klavis AI: MCP integration platforms that let AI agents use tools reliably at any scale

5.8K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K

Maestro

mobile-dev-inc

Painless E2E Automation for Mobile and Web

14.8K

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K