mcp-coinbase-commerce

Name: mcp-coinbase-commerce
Author: codespar

本地服务

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

代码仓库

关于 mcp-coinbase-commerce

mcp-coinbase-commerce 是 Coinbase Commerce 的 MCP 服务，用于商户接收加密货币付款。商家可以用本地法币定价，买家以 BTC、ETH、USDC 等资产结算。适合需要让 Agent 创建收款、账单和结账页面的商户与开发者。

主要功能

01创建加密货币收款单（charge）
02可重复付款的托管结账页面
03创建定向发送给收件人的账单（invoice）
04查询汇率与收款事件
05本地校验 Webhook 签名

适用场景

01让 Agent 为买家生成加密货币收款链接
02管理可重复使用的结账页面与商品收款
03跟踪收款状态并核对 Webhook 事件

MCP 相关

该服务以 18 个 MCP 工具的形式暴露收款单、结账页、账单、事件和汇率等操作，供 MCP 客户端调用。

配置

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

mcp.json · 通用配置

{
  "mcpServers": {
    "codespar-mcp-coinbase-commerce": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-coinbase-commerce"
      ],
      "env": {
        "COINBASE_COMMERCE_API_KEY": "<COINBASE_COMMERCE_API_KEY>",
        "COINBASE_COMMERCE_API_VERSION": "<COINBASE_COMMERCE_API_VERSION>",
        "COINBASE_COMMERCE_WEBHOOK_SECRET": "<COINBASE_COMMERCE_WEBHOOK_SECRET>"
      }
    }
  }
}

启动命令npx -y @codespar/mcp-coinbase-commerce

需要配置的环境变量

COINBASE_COMMERCE_API_KEY密钥Coinbase Commerce API key. Create one at https://beta.commerce.coinbase.com/settings/security.

COINBASE_COMMERCE_API_VERSIONCoinbase Commerce API version pin (X-CC-Version header). Defaults to 2018-03-22.

COINBASE_COMMERCE_WEBHOOK_SECRET密钥Shared secret used to verify X-CC-Webhook-Signature on incoming webhooks. Only required for the verify_webhook_signature tool.

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

安装包

npm@codespar/mcp-coinbase-commerce0.2.2stdio

工具

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

参数	类型	必填	说明
name	string	是	托管支付页面上显示的简短产品／订单名称
metadata	object	否	希望在事件中原样返回的任意 JSON（customer_id、order_id 等）
cancel_url	string	否	买家放弃托管页面时的浏览器重定向地址
description	string	是	买家付款内容的较长易读说明
local_price	object	否	为收款单报价所用的法币计价价格。pricing_type 为 fixed_price 时必填。
local_price.amount	string	是	以十进制字符串表示的金额（例如："29.90"）
local_price.currency	string	是	ISO-4217 法定货币代码（例如：USD、BRL、EUR、MXN）
pricing_type	enum	是	fixed_price：金额为 local_price 中的确切金额。no_price：由买家自行选择（捐赠）。fixed_price \| no_price
redirect_url	string	否	付款成功后的浏览器重定向地址

详细介绍

@codespar/mcp-coinbase-commerce

面向 Coinbase Commerce 的 MCP 服务——全球加密货币商户支付。

Coinbase Commerce 面向接受加密货币支付的商户。商店以当地法币（USD、BRL、EUR、MXN，……）标价，买家使用 BTC / ETH / USDC / 及其他受支持的资产付款，而 Coinbase 会按你选择的加密货币或法币结算给你。

与目录中其他服务的定位

服务	用例	方向
`@codespar/mcp-coinbase-commerce`	商户在结账时接受加密货币	买家向商户付款
`@codespar/mcp-unblockpay`	BRL / MXN <-> USDC 通道	价值转移
`@codespar/mcp-moonpay`	终端用户法币 <-> 加密货币（100+ 种资产）	入金 / 出金
`@codespar/mcp-transak`	终端用户法币 <-> 加密货币（覆盖广泛地区）	入金 / 出金

当 Agent 需要向买家收取加密货币时，请使用 Coinbase Commerce——可使用托管付款页面、可重复使用的结账页面或指定收款对象的账单。

工具（18）

工具	用途
`create_charge`	创建加密货币收款请求——一次性商户账单，以当地法币标价，买家可使用 BTC、E……付款
`retrieve_charge`	通过 Coinbase Commerce ID 或短代码检索收款请求（短代码是嵌入托管……中的 8 个字符代码）
`list_charges`	按时间倒序列出收款请求。
`cancel_charge`	取消尚未付款的收款请求。
`resolve_charge`	手动将收款请求标记为已付款。
`create_checkout`	创建可重复使用的托管结账页面——可将其视为类似商品页面的链接，支持多次付款。
`retrieve_checkout`	按 ID 检索结账页面。
`list_checkouts`	按时间倒序列出可重复使用的托管结账页面。
`update_checkout`	更新现有的可重复使用结账页面。
`delete_checkout`	删除可重复使用的结账页面。
`list_events`	列出事件——生命周期信号（charge:created、charge:confirmed、charge:failed、charge:delayed、charg……）
`retrieve_event`	按 ID 检索单个事件。
`create_invoice`	创建账单——发送给指定姓名收件人的定向账单。
`retrieve_invoice`	按代码检索账单。
`list_invoices`	按时间倒序列出账单。
`void_invoice`	作废未付款的账单。
`list_exchange_rates`	获取指定基础资产的 Coinbase 当前汇率（例如，
`verify_webhook_signature`	本地辅助工具——使用 HMAC-SHA256 验证 Coinbase Commerce webhook 负载。

安装

npm install @codespar/mcp-coinbase-commerce

环境

COINBASE_COMMERCE_API_KEY="..."         # API key (required, secret)
COINBASE_COMMERCE_API_VERSION="..."     # Optional. Defaults to 2018-03-22.

在 https://beta.commerce.coinbase.com/settings/security 创建 API 密钥。

身份验证

每个请求都携带两个标头：

X-CC-Api-Key: <COINBASE_COMMERCE_API_KEY>
X-CC-Version: 2018-03-22

版本标头为必填项。请固定其版本，避免未来的 API 更改在不经意间破坏集成。

运行

# stdio (default — for Claude Desktop, Cursor, etc)
npx @codespar/mcp-coinbase-commerce

# HTTP (for server-to-server testing)
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-coinbase-commerce