mcpField
M
mcp-focus-nfe

mcp-focus-nfe

本地服务
github.com/codespar金融数据2754 周前更新
代码仓库

关于 mcp-focus-nfe

mcp-focus-nfe 是面向巴西 Focus NFe 服务的 MCP 服务，用于开具、查询和取消 NFe、NFSe、NFCe 等电子税务文件。适合需要处理巴西开票业务的 Agent 与开发者。项目提供沙盒环境用于测试。

主要功能

  1. 01开具 NFe、NFSe 与 NFCe 电子发票
  2. 02查询发票详情与状态
  3. 03取消已授权的电子发票
  4. 04获取 NFe 的 DANFE PDF 下载链接
  5. 05发送 NFe 更正函（CCe）
  6. 06管理 webhook 通知（gatilho）

适用场景

  1. 01Agent 根据销售数据自动开具 NFe
  2. 02查询 NFSe 开票状态并在需要时取消
  3. 03通过 webhook 接收发票事件通知

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露 19 个工具，覆盖多种巴西电子税务文件的开具、查询、取消与 webhook 管理。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-focus-nfe": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-focus-nfe"
      ],
      "env": {
        "FOCUS_NFE_TOKEN": "<FOCUS_NFE_TOKEN>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-focus-nfe
需要配置的环境变量
FOCUS_NFE_TOKEN密钥API key for focus-nfe

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包
npm@codespar/mcp-focus-nfe0.2.2

工具

19

收录的工具列表 · 更新于 2 周前

参数类型必填说明
refstring是此 NFe 的唯一参考 ID
itemsarray是NFe 项目
cnpj_emitentestring是开票方 CNPJ
tipo_documentonumber是单据类型（0=entrada，1=saida）
forma_pagamentostring否付款方式代码
cpf_destinatariostring否收件方 CPF
cnpj_destinatariostring否收件方 CNPJ
natureza_operacaostring是业务性质（例如 'Venda de mercadoria'）
nome_destinatariostring否收件人姓名

详细介绍

@codespar/mcp-focus-nfe

Focus NFe 的 MCP 服务 — 用于开具 NFe、NFSe 和 NFCe 财务单据

npm License: MIT

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "focus-nfe": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-focus-nfe"],
      "env": {
        "FOCUS_NFE_TOKEN": "your-token",
        "FOCUS_NFE_SANDBOX": "true"
      }
    }
  }
}
Claude Code
claude mcp add focus-nfe -- npx @codespar/mcp-focus-nfe
Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "focus-nfe": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-focus-nfe"],
      "env": {
        "FOCUS_NFE_TOKEN": "your-token",
        "FOCUS_NFE_SANDBOX": "true"
      }
    }
  }
}

工具（19 个）

工具用途
create_nfe创建并开具 NFe（电子发票）
get_nfe根据引用获取 NFe 详情和状态
cancel_nfe取消已获授权的 NFe（开具后 24 小时内）
get_nfe_pdf获取 NFe PDF（DANFE）下载链接
send_correction_letter为已获授权的 NFe 发送更正函（Carta de Correcao / CCe）
create_nfse创建并开具 NFSe（服务发票）
get_nfse根据引用获取 NFSe 详情和状态
cancel_nfse取消已获授权的 NFSe
create_nfce创建并开具 NFCe（电子消费者发票）
get_nfce根据引用获取 NFCe 详情和状态
cancel_nfce取消已获授权的 NFCe
create_cte为货物运输创建并开具 CTe（电子运输单据）
get_cte根据引用获取 CTe 详情和状态
cancel_cte取消已获授权的 CTe
create_mdfe为货物运输清单创建并开具 MDFe（电子财务单据清单）
close_mdfe行程完成后关闭/完成 MDFe（encerramento）
register_webhook注册 webhook 触发器（gatilho），在财务单据事件发生时通知你的 URL
list_webhooks列出所有已注册的 webhook（gatilhos）
delete_webhook根据 ID 删除已注册的 webhook

身份验证

Focus NFe 使用 Basic Auth，将 API 令牌作为用户名，密码留空。

沙盒 / 测试

Focus NFe 提供位于 homologacao.focusnfe.com.br 的认证测试环境。设置 FOCUS_NFE_SANDBOX=true 即可使用。

获取凭据
  1. 前往 Focus NFe
  2. 创建账户
  3. 从控制面板获取 API 令牌
  4. 设置 FOCUS_NFE_TOKEN 环境变量

环境变量

变量必需描述
FOCUS_NFE_TOKEN是Focus NFe 的 API 令牌
FOCUS_NFE_SANDBOX否设置为 "true" 以启用认证测试模式

路线图

v0.2（计划中）
  • create_cte — 创建 CT-e（电子运输单据）
  • get_cte — 根据 ID 获取 CT-e 详情
  • correction_letter — 为 NF-e 开具更正函
  • manifest_recipient — 确认 NF-e 的收件方知悉状态
  • get_nfse_pdf — 获取服务发票（NFS-e）的 PDF
v0.3（计划中）
  • batch_nfe — 在单个请求中创建多个 NF-e
  • batch_nfse — 在单个请求中创建多个 NFS-e

想要贡献？提交 PR 或申请工具。

链接

企业版

需要为 Agent 付款设置治理、预算限额和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上增加了策略引擎、付款路由和合规模板。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。