mcp-iugu

@codespar/mcp-iugu

用于 iugu 的 MCP 服务 — 发票、订阅和支付管理

快速开始

Claude Desktop

添加到 ~/.config/claude/claude_desktop_config.json：

{
  "mcpServers": {
    "iugu": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-iugu"],
      "env": {
        "IUGU_API_TOKEN": "your-token"
      }
    }
  }
}

Claude Code

claude mcp add iugu -- npx @codespar/mcp-iugu

Cursor / VS Code

添加到 .cursor/mcp.json 或 .vscode/mcp.json：

{
  "servers": {
    "iugu": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-iugu"],
      "env": {
        "IUGU_API_TOKEN": "your-token"
      }
    }
  }
}

工具（23 个）

工具	用途
create_invoice	在 iugu 中创建发票（Pix、boleto 或信用卡）
get_invoice	根据 ID 获取发票详情
list_invoices	列出发票，可选使用筛选条件
cancel_invoice	取消（删除）发票。
refund_invoice	退还已支付发票的款项（全额或部分）。
duplicate_invoice	复制现有发票并设置新的到期日。
create_customer	在 iugu 中创建客户
update_customer	更新客户。
list_customers	列出客户，可选使用筛选条件
create_plan	创建订阅计划（定期订阅模板）。
update_plan	更新现有计划。
list_plans	列出订阅计划。
create_subscription	在 iugu 中创建定期订阅
suspend_subscription	暂停订阅。
activate_subscription	重新启用已暂停的订阅。
cancel_subscription	取消（删除）订阅。
create_payment_token	在服务端将信用卡令牌化。
create_payment_method	将支付方式（信用卡令牌）关联到客户。
create_subaccount	创建市场子账户。
create_transfer	在 iugu 账户之间转账（市场）。
request_withdraw	请求从子账户提现到银行账户（saque）。
create_webhook	为 iugu 事件注册 webhook（gatilho）。
get_account_info	获取账户信息、配置和余额

身份验证

iugu 使用 Basic Auth，将 API 令牌用作用户名，密码留空。

沙盒 / 测试

iugu 可通过控制面板启用测试模式。使用测试模式 API 令牌，避免产生实际扣款。

获取凭据

1. 前往 iugu Developer Portal
2. 创建账户并访问控制面板
3. 切换到测试模式并生成 API 令牌
4. 设置 IUGU_API_TOKEN 环境变量

环境变量

变量	必需	描述
IUGU_API_TOKEN	是	来自 iugu 控制面板的 API 令牌
IUGU_SANDBOX	否	设置为 "true" 以启用测试模式

路线图

v0.3（计划中）

• create_split — 创建分账规则
• list_transfers — 列出市场转账
• get_financial_report — 财务摘要报告
• batch_invoices — 在单次请求中创建多张发票
• list_payment_methods — 列出客户已保存的支付方式

想要参与贡献？提交 PR 或请求添加工具。

链接

• iugu 网站
• iugu API 文档
• MCP Dev LATAM
• 落地页

企业版

需要为 Agent 支付设置治理、预算限额和审计跟踪？CodeSpar Enterprise 在这些 MCP 服务之上提供策略引擎、支付路由和合规模板。

许可证

MIT