mcpField
M
mcp-coinbase-cdp

mcp-coinbase-cdp

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

关于 mcp-coinbase-cdp

mcp-coinbase-cdp 是一个面向 Coinbase Developer Platform（CDP）的 MCP 服务，在同一个 CDP 密钥下覆盖 Trading、Wallets 和 Payments 三类产品。它适合需要在链上完成兑换、钱包操作和付款的开发者。与 Coinbase 其他 MCP 服务不同，它使用 ES256 JWT 认证。

主要功能

  1. 01覆盖 Trading、Wallets、Payments 三类 CDP 产品
  2. 02使用同一 CDP 密钥完成认证
  3. 03链上兑换、取消与查询
  4. 04钱包创建、余额查询与转账
  5. 05链上付款的创建、查询与取消

适用场景

  1. 01让 Agent 查询报价并执行链上兑换
  2. 02管理钱包余额与交易记录
  3. 03创建并跟踪链上付款

MCP 相关

该服务以 MCP 工具的形式暴露 15 个操作，供 MCP 客户端调用，涵盖兑换、钱包和付款。支持 stdio 与 HTTP 两种运行方式。

配置

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

mcp.json · 通用配置
{
  "mcpServers": {
    "codespar-mcp-coinbase-cdp": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-coinbase-cdp"
      ],
      "env": {
        "COINBASE_CDP_KEY_NAME": "<COINBASE_CDP_KEY_NAME>",
        "COINBASE_CDP_PRIVATE_KEY": "<COINBASE_CDP_PRIVATE_KEY>"
      }
    }
  }
}
启动命令npx -y @codespar/mcp-coinbase-cdp
需要配置的环境变量
COINBASE_CDP_KEY_NAME密钥CDP key id of the form organizations/<org>/apiKeys/<id>. Mint at https://portal.cdp.coinbase.com.
COINBASE_CDP_PRIVATE_KEY密钥PEM-encoded ECDSA P-256 private key downloaded once at mint time from https://portal.cdp.coinbase.com. Pass the full PEM including BEGIN/END lines.

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

安装包
npm@codespar/mcp-coinbase-cdp0.1.1

工具

15

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

参数类型必填说明
limitinteger否每页大小
cursorstring否来自先前响应的分页游标

详细介绍

@codespar/mcp-coinbase-cdp

适用于 Coinbase Developer Platform (CDP) 的 MCP 服务——一个 npm 包通过一个密钥涵盖 三个 CDP 产品领域：

  • Trading — 链上兑换／交易 API
  • Wallets — Smart／Embedded／MPC 钱包基础功能
  • Payments — 链上付款基础设施

这三项产品都关联同一个 CDP 账户，共用一个 ES256 JWT 签名密钥和一个基础 URL（https://api.cdp.coinbase.com），因此它们作为一个包发布，而不是三个包。

与目录中其他服务的定位对比

服务Coinbase 产品领域身份验证
@codespar/mcp-coinbaseAdvanced Trade 交易所（旧版零售服务）HMAC API 密钥（CB-ACCESS-*）
@codespar/mcp-coinbase-commerceCommerce 商户网关（在结账时接受 BTC/ETH/USDC）API 密钥（X-CC-Api-Key）
@codespar/mcp-coinbase-cdpDeveloper Platform（Trading + Wallets + Payments）ES256 JWT（本包）

每个产品领域都有独立的 API 主机、密钥类型和控制面板，凭据彼此不通用。请为所需的产品领域创建相应的密钥。

工具（15 个）

Trading（4 个）
工具用途
list_quotes列出经身份验证的 CDP 账户创建的近期兑换报价。
create_swap在两种资产之间创建链上兑换。
get_swap根据 ID 获取单笔兑换——包括完整状态、已执行金额、Gas 和交易哈希。
cancel_swap在待处理的兑换上链前取消。
Wallets（7 个）
工具用途
create_wallet创建新钱包（smart／embedded／MPC）。
list_wallets列出经身份验证的 CDP 账户下的钱包。
get_wallet根据 ID 获取单个钱包。
list_balances列出所有地址和网络上的资产余额。
transfer从钱包向目标地址发送转账。
get_transaction根据 ID 获取单笔交易。
list_transactions列出钱包的历史交易。
Payments（4 个）
工具用途
create_payment创建链上付款（向收款方转出资金）。
list_payments列出历史付款。
get_payment根据 ID 获取单笔付款。
cancel_payment在待处理的付款上链前取消。

安装

npm install -g @codespar/mcp-coinbase-cdp

环境变量

COINBASE_CDP_KEY_NAME="organizations/<org>/apiKeys/<id>"
COINBASE_CDP_PRIVATE_KEY="-----BEGIN EC PRIVATE KEY-----
...
-----END EC PRIVATE KEY-----"

在 https://portal.cdp.coinbase.com 创建密钥（并仅下载一次 PEM 文件——之后无法重新获取）。同一密钥可用于 Trading、Wallets 和 Payments 的身份验证。

重要提示 — PEM 必须是完整的多行内容，包括 BEGIN／END 行。通过 shell 环境变量提供时，请用双引号括起并保留换行符（或使用 $'...'／.env 文件）。

身份验证

CDP 会在 Authorization: Bearer … 标头中使用全新的 ES256 JWT 对每个请求签名。

JWT 声明（每个请求）：

声明值
subCOINBASE_CDP_KEY_NAME
iss"cdp"
aud["cdp_service"]
nbfnow（Unix 秒）
expnow + 120
uri"<METHOD> api.cdp.coinbase.com<path>"（路径包括任何查询字符串）

JWT 标头：

字段值
alg"ES256"
typ"JWT"
kidCOINBASE_CDP_KEY_NAME
nonce随机 16 字节十六进制值（每个请求生成）

使用 COINBASE_CDP_PRIVATE_KEY 中的 ECDSA P-256 私钥签名。PEM 在启动时导入一次并缓存——每个请求只生成 JWT。

运行

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

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

企业版

需要为 Agent 驱动的链上交易提供治理、预算限额和审计追踪？CodeSpar Enterprise 可在这些 MCP 服务之上添加策略引擎、付款路由和合规模板。

许可证

MIT

评论

支持 Markdown

第一次接触 MCP？

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

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