mcp-facturapi

Name: mcp-facturapi
Author: codespar

本地服务

github.com/codespar金融数据2754 周前更新

代码仓库

关于 mcp-facturapi

mcp-facturapi 是面向墨西哥 CFDI 电子发票平台 FacturAPI 的 MCP 服务，可用于开具发票、管理客户与产品以及发送发票。服务同时支持 stdio 与 HTTP 两种传输方式。

主要功能

01CFDI 发票创建、查询与取消
02发票 PDF 与 XML 下载链接
03发票邮件发送
04客户与产品的增删改查
05收据创建与列表查询

适用场景

01由 AI Agent 为墨西哥客户开具 CFDI 发票
02批量查询发票并获取 PDF 或 XML 文件
03维护发票所用的客户与产品资料

MCP 相关

该服务以 MCP 服务形式向客户端暴露 20 个工具，用于调用 FacturAPI 的发票、客户、产品和收据接口。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "codespar-mcp-facturapi": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-facturapi"
      ],
      "env": {
        "FACTURAPI_API_KEY": "<FACTURAPI_API_KEY>"
      }
    }
  }
}

启动命令npx -y @codespar/mcp-facturapi

需要配置的环境变量

FACTURAPI_API_KEY密钥API key for FacturAPI

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

安装包

npm@codespar/mcp-facturapi0.2.2stdio

工具

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

参数	类型	必填	说明
use	string	否	CFDI 用途代码（例如 G01=购置、G03=费用、P01=待定义）
items	array	是	发票明细项
series	string	否	发票系列
customer	string	是	客户 ID
folio_number	number	否	发票编号
payment_form	string	是	SAT 付款方式代码（例如 01=现金、03=转账、04=信用卡）
payment_method	string	否	PUE（一次性付款）或 PPD（延期付款）

详细介绍

MCP FacturAPI

FacturAPI 的 MCP 服务——墨西哥 CFDI 电子发票平台（相当于巴西的 NFe）。

快速开始

# Set your API key
export FACTURAPI_API_KEY="sk_..."

# Run via stdio
npx tsx packages/mexico/facturapi/src/index.ts

# Run via HTTP
npx tsx packages/mexico/facturapi/src/index.ts --http

环境变量

变量	必填	说明
`FACTURAPI_API_KEY`	是	从 FacturAPI 控制台获取的 API 密钥
`MCP_HTTP`	否	设置为 `"true"` 以启用 HTTP 传输
`MCP_PORT`	否	HTTP 端口（默认值：3000）

工具（20 个）

工具	用途
`create_invoice`	创建 CFDI 发票
`get_invoice`	按 ID 获取发票
`list_invoices`	根据筛选条件列出发票
`cancel_invoice`	取消发票
`download_invoice_pdf`	下载 PDF 格式的发票（返回下载 URL）
`download_invoice_xml`	下载 XML 格式的发票（返回下载 URL）
`send_invoice_email`	通过电子邮件向客户或指定收件人发送发票（PDF + XML）
`create_customer`	创建开票客户
`get_customer`	按 ID 获取客户
`list_customers`	列出客户，可选使用筛选条件
`update_customer`	更新现有客户（部分更新）
`delete_customer`	删除客户
`create_product`	创建用于开票的产品
`get_product`	按 ID 获取产品
`list_products`	列出产品
`update_product`	更新现有产品（部分更新）
`delete_product`	删除产品
`create_receipt`	创建收据（recibo de venta）——客户之后可通过收据的 folio 自行开具发票
`list_receipts`	根据筛选条件列出收据
`list_webhooks`	列出已配置的 Webhook