mcpField
C
cte-mdfe-mcp

cte-mdfe-mcp

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

关于 cte-mdfe-mcp

cte-mdfe-mcp 为巴西运输业务的 AI Agent 提供 CT-e 和 MDF-e 的开具与查询能力，通过 Focus NFe 处理相关操作。工具还支持取消已授权的 CT-e 和结束已授权的 MDF-e。

主要功能

  1. 01开具 CT-e
  2. 02查询 CT-e 状态和文件
  3. 03取消已授权 CT-e
  4. 04开具 MDF-e
  5. 05查询 MDF-e 状态和文件
  6. 06结束已授权 MDF-e

适用场景

  1. 01为巴西运输业务开具 CT-e
  2. 02查询 CT-e 状态并下载文件
  3. 03取消已授权的 CT-e
  4. 04结束已授权的 MDF-e

MCP 相关

该 MCP 服务向 AI Agent 提供通过 Focus NFe 开具、查询和处理 CT-e 与 MDF-e 的工具。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "faviosenger-cte-mdfe": {
      "command": "npx",
      "args": [
        "-y",
        "cte-mdfe-mcp"
      ],
      "env": {
        "FOCUS_NFE_TOKEN": "<FOCUS_NFE_TOKEN>",
        "FOCUS_NFE_AMBIENTE": "<FOCUS_NFE_AMBIENTE>"
      }
    }
  }
}
启动命令npx -y cte-mdfe-mcp
需要配置的环境变量
FOCUS_NFE_TOKEN密钥Token da conta Focus NFe
FOCUS_NFE_AMBIENTEhomologacao (padrao) ou producao

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

安装包
npmcte-mdfe-mcp0.1.0

工具

6

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

参数类型必填说明
refstring是文档的唯一标识符
dadosobject是提供商格式的 CT-e 财税数据

详细介绍

cte-mdfe-mcp

npm version

通过 Focus NFe 为巴西的 AI Agent 开具和查询 CT-e 与 MDF-e（运输税务单据）。

安装（Claude Desktop）

{
  "mcpServers": {
    "cte-mdfe-mcp": {
      "command": "npx",
      "args": ["-y", "cte-mdfe-mcp"],
      "env": {
        "FOCUS_NFE_TOKEN": "...",
        "FOCUS_NFE_AMBIENTE": "..."
      }
    }
  }
}

无需凭据即可测试："env": { "PROVIDER": "mock" }。

工具

  • emitir_cte — 开具 CT-e（电子运输单据）
  • consultar_cte — 查询 CT-e 的状态并下载相关文件
  • cancelar_cte — 取消已授权的 CT-e
  • emitir_mdfe — 开具 MDF-e（电子税务单据清单）
  • consultar_mdfe — 查询 MDF-e 的状态并下载相关文件
  • encerrar_mdfe — 结束已授权的 MDF-e

许可证

MIT © Favio Senger

评论

支持 Markdown

第一次接触 MCP？

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

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