mcpField
M
mcp-flow-cl

mcp-flow-cl

本地服务
github.com/codespar金融数据2754 周前更新
代码仓库

关于 mcp-flow-cl

mcp-flow-cl 是面向智利 PSP Flow.cl 的 MCP 服务，可创建托管支付订单、查询支付与退款状态。适合需要在智利收款的 Agent 与开发者。服务端自动完成 HMAC-SHA256 签名。

主要功能

  1. 01创建托管支付订单并返回支付链接
  2. 02按 Flow token、商户订单号或 Flow 订单号查询状态
  3. 03按日期分页列出已收款项
  4. 04创建全额或部分退款及查询退款状态
  5. 05自动完成 HMAC-SHA256 请求签名
  6. 06支持 sandbox 与 production 环境切换

适用场景

  1. 01Agent 为客户生成 Webpay 或 ETpay 支付链接
  2. 02按订单号核对支付是否已完成
  3. 03对已付款订单发起部分退款

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露 8 个支付相关工具，覆盖订单创建、状态查询与退款。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-flow-cl": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-flow-cl"
      ],
      "env": {
        "FLOW_API_KEY": "<FLOW_API_KEY>",
        "FLOW_SECRET_KEY": "<FLOW_SECRET_KEY>",
        "FLOW_ENV": "<FLOW_ENV>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-flow-cl
需要配置的环境变量
FLOW_API_KEY密钥Flow merchant API key
FLOW_SECRET_KEY密钥Flow secret key used to HMAC-SHA256 sign every request
FLOW_ENVEnvironment: 'sandbox' or 'production'. Defaults to 'sandbox'.

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

安装包
npm@codespar/mcp-flow-cl0.1.0

工具

8

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

参数类型必填说明
emailstring是客户电子邮件
amountnumber是扣款金额（CLP 为整数）
subjectstring是向客户显示的支付说明
timeoutnumber否支付订单保持有效的秒数（省略 = 永不过期）
currencystring否货币（CLP 或 UF）。默认值为 CLP
optionalobject否在 getStatus 中回传的额外字段的可选 JSON
urlReturnstring是客户付款后返回的 URL
commerceOrderstring是您的唯一订单 ID
paymentMethodnumber否1 表示 Webpay，3 表示所有银行卡，5 表示 Onepay，8 表示 ETpay，9 表示所有已启用的支付方式。默认值为 9
urlConfirmationstring是服务器到服务器的确认回调 URL（POST，接收 token）

详细介绍

@codespar/mcp-flow-cl

Flow（flow.cl）的 MCP 服务——面向智利本土的 PSP：一个托管支付订单即可支持 Webpay（信用卡/借记卡）、ETpay 银行转账、现金网络和国际银行卡。支持退款。每次 API 调用均使用 HMAC-SHA256 签名。

npm License: MIT

快速开始

Claude Desktop

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

{
  "mcpServers": {
    "flow-cl": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-flow-cl"],
      "env": {
        "FLOW_API_KEY": "your-flow-api-key",
        "FLOW_SECRET_KEY": "your-flow-secret-key",
        "FLOW_ENV": "sandbox"
      }
    }
  }
}
Claude Code
claude mcp add flow-cl --env FLOW_API_KEY=... --env FLOW_SECRET_KEY=... -- npx -y @codespar/mcp-flow-cl
Cursor / VS Code

将相同的代码块添加到 .cursor/mcp.json 或 .vscode/mcp.json。

工具（8 个）

工具端点功能
create_paymentPOST /payment/create创建托管支付订单；返回客户付款页面的 url + token
create_payment_by_emailPOST /payment/createEmailFlow 向客户发送收款链接
get_payment_statusGET /payment/getStatus根据 Flow 令牌查询状态（1 待处理，2 已付款，3 已拒绝，4 已取消）
get_payment_status_by_commerce_idGET /payment/getStatusByCommerceId根据你的 commerceOrder 查询状态
get_payment_status_by_flow_orderGET /payment/getStatusByFlowOrder根据 Flow 订单号查询状态
list_paymentsGET /payment/getPayments查询某日收到的付款（分页）
create_refundPOST /refund/create创建全额或部分退款订单
get_refund_statusGET /refund/getStatus根据退款令牌查询退款状态

身份验证

Flow 会为每个请求签名：参数按字母顺序排序，拼接为 name+value，再使用你的 secretKey 通过 HMAC-SHA256 签名。此服务会代你完成签名——设置两个环境变量后，即可使用普通参数调用工具。

变量必填说明
FLOW_API_KEY是Flow 商户 API 密钥
FLOW_SECRET_KEY是HMAC 签名密钥（不会通过网络发送）
FLOW_ENV否sandbox（默认）或 production

沙盒：在 sandbox.flow.cl 注册——沙盒会签发自己的密钥对。

示例

“创建一个 Flow 支付订单，金额为 25,000 CLP，主题为 ‘Plan Pro mensual’，邮箱为 [email protected]，并提供付款链接。”

Agent 会调用 create_payment 并返回 url?token=...——客户可在 Flow 的托管页面选择 Webpay、ETpay 或现金付款。

企业版

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

托管服务层级

此开源服务会使用你的凭据直接调用 Flow API。CodeSpar 的托管服务层级通过统一接口连接所有 LATAM 服务提供商，并提供自动故障转移、治理、审计和凭据保管库：codespar.dev/agents。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。