mcp-alegra

Name: mcp-alegra
Author: codespar

本地服务

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

代码仓库

关于 mcp-alegra

MCP Alegra 是 Alegra 云会计平台的 MCP 服务，面向拉丁美洲地区的会计与财务场景，覆盖发票、联系人、库存和付款等功能。服务通过 ALEGRA_EMAIL 与 ALEGRA_API_TOKEN 完成认证，支持 stdio 和 HTTP 两种传输方式。

主要功能

01提供 20 个工具，覆盖发票、联系人、商品和付款
02支持通过 stdio 或 HTTP 运行
03使用邮箱与 API 令牌进行 Basic 认证
04提供会计科目分类与银行账户查询

适用场景

01通过 MCP 客户端创建、查询和作废发票
02管理客户与供应商联系人及商品信息
03记录付款并查询银行账户与公司设置

配置

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

mcp.json · 通用配置

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

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

需要配置的环境变量

ALEGRA_EMAILAccount email for Alegra

ALEGRA_API_TOKEN密钥API token for Alegra

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

安装包

npm@codespar/mcp-alegra0.2.2stdio

工具

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

参数	类型	必填	说明
date	string	是	发票日期（YYYY-MM-DD）
items	array	是	发票项目
stamp	object	否	电子发票印花（用于 DIAN）
stamp.generate_stamp	boolean	否	生成电子印花
client	number	是	客户/联系人 ID
currency	string	否	币种代码（COP、USD、MXN）
due_date	string	是	截止日期（YYYY-MM-DD）
observations	string	否	备注/说明
payment_method	string	否	付款方式

详细介绍

MCP Alegra

Alegra 的 MCP 服务——面向拉美地区的云端会计平台（创立于哥伦比亚），支持在 CO、MX、AR、CL 等地区开具发票、管理联系人、库存和付款。

快速开始

# Set your credentials
export ALEGRA_EMAIL="[email protected]"
export ALEGRA_API_TOKEN="your-api-token"

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

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

环境变量

变量	必填	描述
`ALEGRA_EMAIL`	是	账户邮箱地址
`ALEGRA_API_TOKEN`	是	从 Alegra 设置中获取的 API 令牌
`MCP_HTTP`	否	设置为 `"true"` 以启用 HTTP 传输
`MCP_PORT`	否	HTTP 端口（默认值：3000）

工具（20）

工具	用途
`create_invoice`	创建发票
`get_invoice`	按 ID 获取发票详情
`list_invoices`	列出发票
`void_invoice`	作废／取消发票
`get_invoice_pdf`	获取发票 PDF 下载链接
`send_invoice`	通过电子邮件向一个或多个收件人发送发票
`create_contact`	创建联系人（客户或供应商）
`update_contact`	更新现有联系人
`delete_contact`	删除联系人
`list_contacts`	列出联系人
`create_item`	创建产品或服务项目
`update_item`	更新现有项目
`list_items`	列出产品和服务
`list_payments`	列出付款
`get_payment`	按 ID 获取付款
`create_payment`	记录付款
`void_payment`	作废／撤销付款
`list_categories`	列出项目类别（会计科目表）
`list_bank_accounts`	列出银行账户
`get_company`	获取公司资料和设置