mcp-siigo

Name: mcp-siigo
Author: codespar

本地服务

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

代码仓库

关于 mcp-siigo

mcp-siigo 是哥伦比亚会计平台 Siigo 的 MCP 服务，集成 DIAN 电子发票功能。适合需要通过 MCP 客户端管理发票、客户、产品和采购单据的用户。服务使用 Bearer 令牌认证。

主要功能

01DIAN 电子发票与发票 PDF 获取
02贷项通知单（credit note）创建与查询
03客户与产品的增删改查
04采购单据创建与列表
05仓库、税种与付款方式查询

适用场景

01通过 MCP 客户端开具 DIAN 电子发票
02为发票开具贷项通知单
03查询客户、产品与仓库等基础数据

MCP 相关

该项目是 MCP 服务，向 MCP 客户端暴露 22 个工具，用于调用 Siigo API 的发票、客户、产品和单据功能。

配置

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

mcp.json · 通用配置

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

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

需要配置的环境变量

SIIGO_API_KEY密钥API key for Siigo

SIIGO_ACCESS_TOKEN密钥Bearer access token

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

安装包

npm@codespar/mcp-siigo0.2.2stdio

工具

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

参数	类型	必填	说明
date	string	是	发票日期（YYYY-MM-DD）
items	array	是	发票项目
customer	object	是	客户引用
customer.branch_office	number	否	分支机构（默认值为 0）
customer.identification	string	是	客户 NIT 或 CC
document	object	是	证件类型
document.id	number	是	单据类型 ID
payments	array	是	付款方式

详细介绍

MCP Siigo

Siigo 的 MCP 服务——哥伦比亚会计平台，集成 DIAN 电子发票功能。

快速开始

# Set your credentials
export SIIGO_API_KEY="your-api-key"
export SIIGO_ACCESS_TOKEN="your-access-token"

# Run via stdio
npx tsx packages/colombia/siigo/src/index.ts

# Run via HTTP
npx tsx packages/colombia/siigo/src/index.ts --http

环境变量

变量	必填	描述
`SIIGO_API_KEY`	是	Siigo 的 API 密钥
`SIIGO_ACCESS_TOKEN`	是	Bearer 访问令牌
`MCP_HTTP`	否	设置为 `"true"` 以启用 HTTP 传输
`MCP_PORT`	否	HTTP 端口（默认：3000）

工具（22 个）

工具	用途
`create_invoice`	创建发票（DIAN 电子发票）
`get_invoice`	根据 ID 获取发票详情
`list_invoices`	列出发票
`create_credit_note`	为发票创建贷项通知单
`list_customers`	列出客户
`create_customer`	创建客户
`list_products`	列出产品
`create_product`	创建产品
`get_invoice_pdf`	获取发票的 PDF 文档
`get_credit_note`	根据 ID 获取贷项通知单
`list_credit_notes`	列出贷项通知单
`update_customer`	更新现有客户
`delete_customer`	删除客户
`update_product`	更新现有产品
`delete_product`	删除产品
`create_purchase`	创建采购单据
`list_purchases`	列出采购单据
`list_document_types`	列出单据类型（例如，发票用 FV、贷项通知单用 NC、采购用 FC）
`list_users`	列出 Siigo 用户（销售人员）
`list_warehouses`	列出仓库（bodegas）
`list_taxes`	列出可用税种
`list_payment_methods`	列出可用付款方式