mcp-afip

Name: mcp-afip
Author: codespar

本地服务

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

代码仓库

关于 mcp-afip

mcp-afip 是面向阿根廷税务局 AFIP 的 MCP 服务，用于电子发票（Factura Electrónica）开具与 CAE 授权。它面向需要在 AFIP 体系内开票或查询纳税人信息的开发者与财务系统。服务以工具形式封装 WSFE 等 SOAP 接口。

主要功能

01电子发票开具与 CAE 授权查询
02发票、票据及作废操作
03信用票据与借记票据开具
04纳税人 Padrón 信息与登记证明查询
05发票类型、税率、币种等参数查询

适用场景

01为阿根廷企业批量开具电子发票
02查询发票 CAE 授权状态与最后编号
03核对客户的 CUIT 税务状态

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "codespar-mcp-afip": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-afip"
      ],
      "env": {
        "AFIP_CERT_PATH": "<AFIP_CERT_PATH>",
        "AFIP_KEY_PATH": "<AFIP_KEY_PATH>",
        "AFIP_CUIT": "<AFIP_CUIT>"
      }
    }
  }
}

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

需要配置的环境变量

AFIP_CERT_PATHPath to AFIP certificate (.crt)

AFIP_KEY_PATH密钥Path to AFIP private key (.key)

AFIP_CUITCUIT number

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

安装包

npm@codespar/mcp-afip0.2.0-alpha.3stdio

工具

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

参数	类型	必填	说明
items	array	否	发票明细项
concept	number	是	概念（1=产品，2=服务，3=两者）
currency	string	否	货币代码（PES=ARS，DOL=USD）
doc_type	number	是	文档类型（80=CUIT，86=CUIL，96=DNI，99=最终消费者）
amount_iva	number	否	IVA 税额
amount_net	number	否	净应税金额
doc_number	number	是	客户证件号码
amount_total	number	是	发票总金额
invoice_type	number	是	发票类型代码（1=A，6=B，11=C 等）
point_of_sale	number	是	销售点编号

详细介绍

@codespar/mcp-afip

面向阿根廷税务机关 AFIP（Administracion Federal de Ingresos Publicos）的 MCP 服务，用于通过 CAE 授权进行电子开票（Factura Electronica）

Alpha 版本 — 通过 npm alpha dist-tag 发布。端点路径遵循公开文档以及 BACEN／提供商的惯例，但尚未经过全面的线上验证。在 0.x.x-alpha 阶段请固定使用确切版本。使用 npm install @codespar/mcp-afip@alpha 安装。

快速开始

# Set your credentials
export AFIP_CERT_PATH="/path/to/cert.crt"
export AFIP_KEY_PATH="/path/to/key.key"
export AFIP_CUIT="20123456789"

# Run via stdio
npx -y @codespar/mcp-afip@alpha

# Run via HTTP
MCP_HTTP=true MCP_PORT=3000 npx -y @codespar/mcp-afip@alpha

环境变量

变量	必填	说明
`AFIP_CERT_PATH`	是	AFIP 证书（.crt）的路径
`AFIP_KEY_PATH`	是	AFIP 私钥（.key）的路径
`AFIP_CUIT`	是	纳税人的 CUIT 号码
`AFIP_ENV`	否	`"production"` 或 `"homologation"`（默认值：homologation）
`MCP_HTTP`	否	设置为 `"true"` 以启用 HTTP 传输
`MCP_PORT`	否	HTTP 端口（默认值：3000）

工具（20）

工具	用途
`create_invoice`	通过 AFIP 创建电子发票（Factura Electrónica）
`get_invoice`	根据类型、销售点和号码获取发票详情
`get_last_invoice_number`	获取某个销售点和类型的最后一个已授权发票号码
`get_cae_status`	检查发票的 CAE 授权状态
`list_invoice_types`	列出可用的发票类型（Factura A、B、C 等）
`list_tax_types`	列出可用的税种（IVA、percepciones、retenciones 等）
`get_server_status`	检查 AFIP Web 服务的可用性（WSFE 状态）
`get_authorized_points_of_sale`	列出该 CUIT 的已授权销售点
`create_invoice_batch`	在单个 CAE 请求中批量创建发票（FECAESolicitar，最多 250 张）
`create_credit_note`	开具引用原始发票的贷项通知单（Nota de Crédito A/B/C：类型 3、8、13）
`create_debit_note`	开具引用原始发票的借项通知单（Nota de Débito A/B/C：类型 2、7、12）
`cancel_invoice`	取消／作废已授权发票（FECancel — 仅限特定类型／条件）
`get_invoice_total_x_request`	获取每个 FECAESolicitar 请求允许的最大记录数（FECompTotXRequest）
`list_concept_types`	列出可用的概念类型（FEParamGetTiposConcepto：1=产品，2=服务，3=两者）
`list_doc_types`	列出证件／标识类型（FEParamGetTiposDoc：80=CUIT，86=CUIL，96=DNI，99=最终消费者）
`list_iva_types`	列出 IVA 税率档次（FEParamGetTiposIva：21%、10.5%、27%、0% 等）
`list_currency_types`	列出支持的货币（FEParamGetTiposMonedas）
`get_currency_rate`	获取某种货币兑 ARS 的汇率（cotización）（FEParamGetCotizacion）
`lookup_taxpayer`	按 CUIT 查询税务登记信息（WS_SR_PADRON A4/A5/A13 — 税务状态、姓名、地址）
`get_registration_certificate`	获取某个 CUIT 的注册证明（constancia de inscripción）