@coinbase/cdp-cli (英语)
命令行接口 Coinbase 开发者平台认证一次,从终端或AI代理访问每个API.
零运行时间依赖性——仅Node.js 22+.
安装
npm install -g @coinbase/cdp-cli
快开始
# 1. Set up your API key (get one at portal.cdp.coinbase.com)
cdp env live --key-file ./cdp-api-key.json
# 2. Make a request
cdp evm accounts list
# 3. Explore the API
cdp api
图标
cdp env ——管理 API 密钥
配置 API 密钥一次; 所有后续的命令自动认证 .
cdp env # list environments
cdp env live --key-file ./cdp-api-key.json # import key file from Portal
cdp env live --key-id <id> --key-secret <secret> # configure inline
cdp env live --remove # remove an environment
多个 API 密钥 — 前缀 live 以不同的密钥继承其 URL :
cdp env live-team-a --key-id <id> --key-secret <secret> # inherits live URL, switches to live-team-a
cdp env live # switch back to live
cdp evm accounts list -e live-team-a # one-off override without switching
钱包的秘密
账户写入操作(创建,签名,发送)需要钱包密钥. 生成一个在 门户网站.cdp.coinbase.com/产品/服务器-钱包/账户,然后添加到您的环境中:
cdp env live --wallet-secret <secret>
# or, load from file
cdp env live --wallet-secret-file ./cdp_wallet_secret.txt
cdp evm accounts create name=my-wallet # now works
钱包密钥存储在您的 OS 密钥环和 API 密钥旁边 。 独立管理 :
cdp env live --wallet-secret-file secret.txt # add or update
cdp env live --remove-wallet-secret # remove (keeps API key)
cdp env # shows (wallet) indicator
一次性使用而无需持续使用(例如,使用秘密管理器的钥匙进行测试):
CDP_WALLET_SECRET=$(cat secret.txt) cdp evm accounts create name=my-wallet
自定义环境名称, 不从 live 需求 --url数字 :
cdp env custom --key-id <id> --key-secret <secret> --url https://api.cdp.coinbase.com/platform/v2
cdp <resource> <action> ——API业务
命令由 CDP OpenAPI spec 生成. 运行 cdp api 以浏览可用的端点.
cdp evm accounts list
cdp evm accounts create name=my-wallet
cdp evm faucet address=0x... network=base-sepolia token=eth
cdp data evm token-balances base 0x...
使用 --template 在写入前查看预期的请求形状,以及 --dry-run 预览而不发送 :
cdp evm accounts create --template # print request body template
cdp evm accounts create --dry-run # preview the assembled request
字段语法 (与 cdp api:
| 语法 | 含义 |
|---|---|
key=value | 字符串正体字段 |
key:=value | Raw JSON 身体场 |
key==value | 查询参数 |
a.b.c=value | 嵌入体场 |
@file.json | 文件正文 |
- | 尸体从 stdin |
Header:value | 自定义 HTTP 页眉 |
资源旗:
| 旗帜 | 行为 |
|---|---|
--template | 将请求体模板打印为 JSON |
--dry-run | 不发送打印请求 |
--edit | 打开请求正文 $EDITOR |
--jq <expr> | 过滤 JSON 响应( 需要) 强克(中文(简体) ) |
--paginate | 自动跟随 nextPageToken 实现全面成果 |
-e <env> | 使用特定环境 |
cdp api - 原始HTTP软件
资源命令未覆盖的端点或方法的下层访问. Auth 自动处理 .
cdp api /evm/accounts
cdp api -X POST /evm/accounts name=my-wallet
cdp api -X POST /evm/accounts @body.json # full body from file
echo '{"name":"my-wallet"}' | cdp api -X POST /evm/accounts -
cdp api /evm/accounts --jq '.accounts[].address' # requires jq
cdp api /evm/accounts --paginate # auto-follow nextPageToken
cdp api /evm/accounts -v # show request + response headers
cdp api – 浏览 API
运行 cdp api 没有参数打开嵌入式 OpenAPI spec 的交互式浏览器.
cdp api # list all API groups
cdp api /evm # endpoints in a group
cdp api /evm/accounts --help # full detail for one endpoint
cdp util 编码和主要公用事业
帮助者命令进行交易编码,ABI编码,以及密钥管理.
cdp util tx-encode --to 0x... --value 1000000 # encode a transaction
cdp util tx-decode 0x... # decode a raw transaction
cdp util abi-encode 'transfer(address,uint256)' 0x... 1000 # ABI-encode calldata
cdp util encrypt-key # encrypt a private key for import
cdp skills - 工作流程技能
管理可重复使用的工作流程技能(即时模板)来扩展MCP服务器.
cdp skills list # list available skills
cdp skills add # install/update all bundled skills
cdp skills add --dir <path> # install to a specific directory
cdp skills remove # remove all installed skills
cdp history - 请求历史
通过 CLI 查看和管理最近 API 请求的日志 .
cdp history # show recent requests
cdp history clear # clear request history
Claude 代码/ MCP
cdp mcp 启动一个 MCP 磁共振 服务器,可以让 Claude 输入工具访问每个 CDP API 端点。 工具由光谱生成——CLI更新时会自动出现新的端点. 工具名映射出嵌入子资源结构(如. evm_accounts_create, (中文(简体) ), evm_accounts_sign_message) (中文(简体) ).
除了API工具外,MCP服务器还披露了用于环境和工作流程管理的元工具:
| 工具 | 目的 |
|---|---|
cdp_set_env | 切换活动 API 环境 |
cdp_env | 显示当前环境和密钥信息 |
cdp_help | 获取 CLI 命令的使用帮助 |
cdp_template | 获取端点请求体模板 |
如果您在全球安装了 CLI :
claude mcp add --scope user --transport stdio cdp -- cdp mcp
仅限 MCP (无需全局安装) npx:
claude mcp add --scope user --transport stdio cdp -- npx -y @coinbase/cdp-cli mcp
如果您同时使用 CLI 和 MCP, 请在全球安装, 这样它们共享相同的版本和光谱 .
或增加你的项目 .mcp.json数字 :
{
"mcpServers": {
"cdp": { "transport": "stdio", "command": "cdp", "args": ["mcp"] }
}
}
自动核准读取操作 内 .claude/settings.json数字 :
{
"permissions": {
"allow": [
"mcp__cdp__cdp_env",
"mcp__cdp__cdp_help",
"mcp__cdp__cdp_template",
"mcp__cdp__cdp_*_list",
"mcp__cdp__cdp_*_get"
]
}
}
配置
环境变量覆盖配置文件值 :
| 变量 | 目的 |
|---|---|
CDP_ENV | 活动环境名称 |
CDP_KEY_ID | API 密钥标识 |
CDP_KEY_SECRET | API 密钥 |
CDP_URL | 基础 URL 覆盖 |
CDP_WALLET_SECRET | 钱包秘密( 选项为 --wallet-secret(中文(简体) ) |
CDP_NO_HISTORY | 设定为 1 以禁用请求历史 |
CDP_CONFIG_DIR | 配置目录( 默认 ): ~/.config/cdp, (中文(简体) ), %APPDATA%\cdp 在窗口上) |
密钥和状态存储于 config.json 在配置目录中.
捐款
见 捐款额。 。 。 .
警卫
见 警卫。 。 。 .