mcp-colppy

Name: mcp-colppy
Author: codespar

本地服务

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

代码仓库

关于 mcp-colppy

mcp-colppy 是 Colppy 的 MCP 服务，Colppy 是阿根廷的云端会计平台，集成了 AFIP 电子发票功能。该服务为仍在 Alpha 阶段的版本，端点尚未完全经过实际验证。适合处理阿根廷会计与开票业务的团队。

主要功能

01客户与供应商的增删改查
02创建发票并集成 AFIP 电子发票
03发票取消、PDF 获取与收款登记
04科目表、余额与库存查询
05销售与支出报表

适用场景

01让 Agent 为阿根廷客户开具电子发票
02查询客户余额与应收账款
03生成销售与支出报表

MCP 相关

该服务以 22 个 MCP 工具的形式暴露客户、发票、收据、库存和报表等操作，供 MCP 客户端调用。

配置

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

mcp.json · 通用配置

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

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

需要配置的环境变量

COLPPY_API_KEY密钥API key for Colppy

COLPPY_COMPANY_IDCompany identifier

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

安装包

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

工具

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

参数	类型	必填	说明
limit	number	否	结果数量上限
filter	string	否	搜索筛选条件（名称或税号）
offset	number	否	分页偏移量

详细介绍

MCP Colppy

Alpha 版本 — 通过 alpha npm dist-tag 发布。端点路径遵循公开文档和 BACEN／提供商惯例，但尚未经过完整的线上验证。在 0.x.x-alpha 阶段，请锁定确切版本。使用 npm install <pkg>@alpha 安装。

Colppy 的 MCP 服务——阿根廷云端会计平台，集成 AFIP 电子发票功能。

快速开始

# Set your credentials
export COLPPY_API_KEY="your-api-key"
export COLPPY_COMPANY_ID="your-company-id"

# Run via stdio
npx tsx packages/argentina/colppy/src/index.ts

# Run via HTTP
npx tsx packages/argentina/colppy/src/index.ts --http

环境变量

变量	必需	描述
`COLPPY_API_KEY`	是	Colppy 的 API 密钥
`COLPPY_COMPANY_ID`	是	公司标识符
`MCP_HTTP`	否	设置为 `"true"` 以启用 HTTP 传输
`MCP_PORT`	否	HTTP 端口（默认值：3000）

工具（22）

工具	用途
`list_customers`	列出客户
`create_customer`	创建客户
`list_products`	列出产品和服务
`create_invoice`	创建发票（集成 AFIP 电子发票功能）
`list_invoices`	列出发票
`get_balance`	获取账户余额汇总
`list_accounts`	列出会计科目表（plan de cuentas）
`create_payment`	记录针对发票的付款
`update_customer`	更新现有客户的数据
`delete_customer`	删除客户
`get_customer_balance`	获取客户当前账户余额（cuenta corriente）
`list_suppliers`	列出供应商（proveedores）
`create_supplier`	创建供应商（proveedor）
`cancel_invoice`	取消／作废发票（anular comprobante）
`get_invoice_pdf`	获取发票的 PDF 文件（返回 URL 或 base64）
`create_receipt`	创建收据（recibo）——记录针对一张或多张发票收到的现金／转账款项
`list_receipts`	列出收据（recibos）
`get_stock`	获取产品在各仓库中的当前库存
`list_warehouses`	列出仓库（depósitos）
`list_companies`	列出当前 API 用户可访问的公司（empresas）
`sales_report`	按日期范围生成销售报告
`expenses_report`	按日期范围生成费用／采购报告