关于 base-mcp
base-mcp 是指导 Agent 使用 Base MCP 的技能,现已更名为 wallet-mcp。它涵盖钱包操作、第三方插件路由及交易审批注意事项。
主要功能
- 01钱包余额、转账与兑换
- 02签名、x402 支付和合约调用
- 03第三方插件选择与操作指引
- 04交易审批及风险提示
适用场景
- 01查询 Base Account 钱包能力
- 02按指定平台执行链上操作
- 03处理需要批准的写入交易
MCP 相关
该技能指导 Agent 检测并使用 Base MCP 暴露的工具,并按需加载操作参考和插件说明。
安装
复制下面的命令,在终端中运行。
npx skills add https:/ / github.com/ base/ skills --skill base-mcp安装后在 Claude Code 中输入/base-mcp确认已加载。
包含的文件
除 SKILL.md 外,安装时一起下载的参考资料和脚本。
README.mdplugins/aerodrome.mdavantis.mdbalancer.mdbankr.mdbitrefill.mdbrickken.mdclawnch.mdflaunch.mdgmgn.mdhydrex.mdkyberswap.mdmoonwell.mdmorpho.mdo1-exchange.mdopensea.mdprintr.mduniswap.mdvenice.mdvirtuals.mdyo.mdreferences/approval-mode.mdbatch-calls.mdcustom-plugins.mdinstall.mdplugin-spec.mdtone.md详细介绍
Base MCP
已弃用: 此技能已更名为
wallet-mcp。请使用npx skills add base/skills --skill wallet-mcp安装。此副本仍可使用,之后将被移除。
重要
每次对话中涉及 Base MCP 时,都要在开始时进行入门说明
即使对话直接进入插件主题也不例外。入门说明很简短,见下文。
检测
连接后,Base MCP 会向执行环境公开其工具。如果没有可调用的 Base MCP 工具,则表示尚未安装 MCP 服务:请引导用户前往 https://docs.cdp.coinbase.com/ai-agents/coinbase-for-agents/wallet-mcp#quickstart(或加载 references/install.md 查看特定应用的步骤),然后停止。
如果 Base MCP 工具可用,请加载 references/tone.md——其中的规则适用于整个对话——然后继续进行入门说明。如果且仅当无法读取同级文件时(例如,只提供了此 SKILL.md 正文,且无法访问技能目录的本地文件系统),请使用 Base MCP 的 web_request 工具,从 https://docs.cdp.coinbase.com/coinbase-for-agents/wallet-mcp/references/tone.md 获取相同的相对路径。此文件中其他所有参考文件和插件链接也适用相同的备用方式(见下方“加载引用文件”)。
入门说明
保持简短。每个会话开始时、开始实际工作前执行一次:
-
简要说明可用功能——用一两句话说明。用户拥有 Base Account 钱包,可以进行余额查询、代币发送和兑换、消息签名、x402 支付、合约调用批处理,以及(如果已安装)使用第三方插件进行 DeFi、兑换和其他链上操作。不要逐一列出所有工具——Agent 会直接从 MCP 发现工具和插件。
-
继续操作前,逐字显示以下免责声明:
使用 Base MCP 即表示你同意 Base Account and Base App 服务条款。Base MCP 提供对第三方构建的插件的访问,这些插件并非由 Base 构建。Base 不运营、认可或审计这些插件,也不对你交互的协议负责。交易不可撤销——批准前请务必仔细检查。
-
钱包地址和余额为可选信息——仅在用户提出要求,或待处理操作确实需要地址时(例如写入调用、查询持仓),才获取并显示。不要一开始就主动提供钱包详情。
工具
Base MCP 会向执行环境公开自己的工具目录。请阅读 MCP 提供的工具说明——这些说明是准确信息来源,且可能随时间变化。不要假定工具列表固定;不要从此技能预加载工具目录。
以下两类模式涉及多个工具,因此有各自的参考文件:
| 主题 | 参考文件 |
|---|---|
| 审批流程(适用于任何会返回审批 URL 的写入工具) | references/approval-mode.md |
| 合约调用批处理(EIP-5792) | references/batch-calls.md |
自定义/非原生插件与 web_request 允许列表 | references/custom-plugins.md |
| 平台安装步骤 | references/install.md |
| 语气和语言规则 | references/tone.md |
加载引用文件
- 默认 — 本地。 从同一目录下的
SKILL.md读取每个references/…或plugins/…链接(通过文件系统读取,例如Read/cat)。这是规范来源——务必先尝试此方式。 - 回退 — 网页(仅当本地读取失败时)。 只有在本地文件确实无法读取时(例如,提供给你的
SKILL.md是粘贴的正文,磁盘上没有对应的技能目录,或者文件系统读取报错),才从https://docs.cdp.coinbase.com/coinbase-for-agents/wallet-mcp/<path>获取相同的相对路径(将<path>替换为相对链接,例如references/tone.md、plugins/morpho.md)。必须使用 Base MCP 的web_request工具来获取此文件——在任何环境中都必须采用此方式,包括内置网页/抓取工具可用的环境。不要跳过此回退,也不要凭记忆或猜测操作——如果本地读取失败,必须先使用web_request获取文件,再根据文件内容执行操作。 - 按需加载。 只有在对话确实需要时才加载引用文件或插件。不要预加载目录内容。
插件
插件为 Base MCP 扩展第三方功能(借贷、兑换、永续合约等)。每个插件都是独立的第三方服务,Base 不运营、背书或审计这些服务。可用插件可能会变化,用户也可能在聊天中追加指令或自定义插件,使你能够使用其他协议。
路由规则 — 必须由名称触发,绝不自动路由
只有当用户点名某个特定第三方平台(例如“在 Uniswap 上兑换”“在 Moonwell 借贷”“在 Bitrefill 购买礼品卡”)或以其他方式明确指向该平台时,才打开相应插件。绝不要根据笼统的功能需求推断平台——选择哪家第三方服务应由用户决定,而不是由你决定。
如果用户提出功能需求但未点名平台——“兑换一些 USDC”“赚取收益”“发行代币”“购买礼品卡”——不要替他们选择插件。应列出下表中支持该功能的插件(并提及同样支持该功能的原生 Base MCP 工具,例如内置的 swap),然后让用户选择。只有在用户点名平台后,才打开对应插件并执行操作。
与此技能一同维护的插件(“原生插件”)。请通过两种方式使用此表:(a) 将已点名平台的请求路由至相应插件;(b) 当用户提出功能需求但未点名平台时,整理可选项列表。“满足以下条件时打开……”一栏中的触发条件有意以各平台自身名称为依据——该名称就是触发条件。
| 插件 | 用户提到此平台并想要……时打开 | 涵盖的常见操作 | 操作前须知 |
|---|---|---|---|
| Aerodrome | 在 Aerodrome 上兑换、提供流动性、质押或领取奖励。 | 发现资金池、兑换、添加/移除 LP、质押、取消质押、领取奖励。 | 仅限 Base。需要支持 shell 的运行环境来使用 Sugar CLI;仅支持聊天的界面请停止操作。 |
| Avantis | 交易杠杆永续期货,或查看 Avantis 交易活动。 | 开仓/平仓、取消订单、调整保证金、设置 TP/SL、查看持仓、历史记录和 PnL。 | 仅限 Base。杠杆可能导致仓位被清算;仅支持聊天的界面可以读取数据,但交易操作请使用 Avantis UI。 |
| Balancer | 在 Balancer 上兑换代币或提供流动性。 | 读取资金池/报价、构建兑换 calldata、添加/移除流动性、通过 send_calls 提交。 | 仅限 CLI——需要 shell 访问权限;仅支持聊天的界面请停止操作。支持多条链(Base、Ethereum、Arbitrum、Optimism、Avalanche);请确认滑点并注意低流动性风险。 |
| Bankr | 发现新发布的代币,或在 Bankr 上购买新发布的代币。 | 读取发布动态、查看代币元数据、购买选定代币。 | 仅限 Base。新代币可能流动性不足或不安全;不要自动购买,并明确说明价格/流动性风险。 |
| Bitrefill | 在 Bitrefill 上购买礼品卡、手机充值或旅行 eSIM,并使用 USDC 付款。 | 搜索 1,500 多个品牌、结账,并在聊天中交付礼品卡代码和 eSIM 详情。 | 仅限 Base。需要 SIWE 登录;购买不可撤销且涉及个人数据——付款前请确认订单详情。 |
| Brickken | 在 Brickken 上管理 ERC-8004 Agent 身份、声誉或 Agent 代币操作。 | 通过 x402 批准执行身份和声誉读取/写入、Agent 代币操作。 | 支持 Base 和 Base Sepolia。写入不可撤销且可能涉及个人数据;批准前请先审核。 |
| Clawnch | 发现最近/热门的代币发布,或在 Clawnch 上发布代币。 | 浏览发布动态、查看代币、非托管式发布、通过 send_calls 兑换。 | 仅限 Base。新代币可能流动性不足或不安全,且发布操作不可撤销;请明确说明风险。 |
| Flaunch | 在 Flaunch 上发布代币,或发现/兑换已部署的 Flaunch 代币。 | 通过 mcp.flaunch.gg 准备发布、发现代币、兑换、通过 send_calls 提交。 | 仅限 Base。新代币可能流动性不足;发布和兑换不可撤销——请先确认详情。 |
| GMGN | 通过 GMGN 获取 Base 上的代币兑换报价、Gas 价格或热门代币市场信息。 | 兑换报价(通过 send_calls 提供未签名 calldata)、Gas 价格档位、热门代币。 | 仅限 Base。仅限 CLI——需要 shell 来生成身份验证参数;使用 API 密钥进行身份验证。请确认滑点并留意低流动性代币。 |
| Hydrex | 在 Hydrex 上兑换代币或管理集中流动性仓位。 | 报价、兑换、添加/移除集中流动性、通过 send_calls 提交。 | 仅限 Base。报价可能变动;写入前请确认滑点。 |
| KyberSwap | 在 KyberSwap 上兑换代币(跨链聚合最优汇率路由)。 | 通过 50 多个流动性来源进行最优汇率路由、获取报价、通过 send_calls 兑换。 | 支持多条链(Base、Ethereum、Arbitrum、Optimism、Polygon、BSC、Avalanche);报价可能变动,兑换前请确认滑点。 |
| Moonwell | 在 Moonwell 上借出、借款、还款、提取,或查看持仓/奖励。 | 市场/利率读取、健康检查、存入、提取、借款、还款、查询奖励。 | 支持 Base 和 Optimism。借款可能被清算;进行高风险操作前,请展示健康因子。 |
| Morpho | 赚取收益、使用 Morpho 金库,或在 Morpho 市场中借款/借出。 | 比较金库、存入或提取、提供抵押品、借款、还款、查看持仓。 | 仅限 Base。借款可能被清算;准备写入操作前,请读取健康状况/持仓数据。 |
| o1.exchange | 在 o1.exchange 上兑换代币,可选择使用 Permit2 免 Gas 授权和受 MEV 保护的路由。 | 报价、通过 send_calls 进行标准兑换、通过私有中继进行 Permit2 兑换。 | 支持多条链(Base、BSC)。报价可能变动,兑换不可撤销;请确认滑点并留意低流动性代币。 |
| OpenSea | 在 OpenSea 上交易 NFT、兑换代币或铸造空投。 | NFT 买入/卖出/挂单、代币兑换、空投/铸造、通过 send_calls 提交。 | 支持多条链(Ethereum、Base、Polygon、Arbitrum、Optimism、Avalanche)。需要 API 密钥;交易不可撤销——请先确认代币、价格和滑点。 |
| Printr | 在 Printr 上发布跨链代币。 | 通过 HTTP API 准备代币创建 calldata,通过 send_calls 提交。 | 支持多条链(Base、Arbitrum、Optimism、Polygon、BSC、Avalanche、Ethereum)。新代币可能流动性不足;发布操作不可撤销。 |
| Uniswap | 兑换代币或管理 Uniswap 流动性仓位。 | 代币兑换、授权检查、V2/V3/V4 LP 创建/增加/减少/领取流程。 | 仅限 Base。报价可能变动;写入前请确认滑点以及代币/仓位详情。 |
| Venice | 在 Venice 上运行私密 AI 推理或媒体生成,可选择使用 x402 充值。 | 通过 Venice API 进行文本和媒体推理,可选择使用 Base x402 钱包充值。 | 仅限 Base。需要 SIWE 登录;推理会处理个人数据,付费调用不可撤销。 |
| Virtuals | 创建或运营 Virtuals AI Agent、支付卡或 Agent 邮箱。 | Agent 管理、卡片设置和限额、邮箱收件箱/邮件线程操作、SIWE 登录。 | 需要 Virtuals MCP 和签名登录。会处理个人数据;避免不必要地暴露令牌、OTP、卡片详情或邮件内容。 |
| YO | 查看 YO 金库、检查持仓、存入,或在 YO 收益金库中申请赎回。 | 通过 chain_rpc_request 读取 ERC-4626 金库数据、存入、通过 send_calls 申请赎回。 | 支持多条链(Base、Ethereum、Arbitrum)。存入和赎回不可撤销;写入前请确认金额和金库。 |
| 仅当用户说出插件所涵盖的平台后,才加载插件参考文件(遵循上述路由规则),并遵循与参考文件相同的本地优先、网页回退规则(参见上文加载引用文件)。对于插件自身的外部工具,优先依据插件文件,然后再依据其明确要求使用的任何 CLI 帮助、API 架构或 MCP 工具说明。 |
原生插件与自定义/用户提供的插件
Base MCP 的 web_request 工具可能已将原生插件的 HTTP 主机列入允许列表。Aerodrome、Balancer 和 GMGN 仅支持 CLI,需要具备 Shell 访问权限的运行框架。Avantis 是混合型:只读查询(市场数据、持仓、PnL)可通过 web_request 在所有平台上使用,而 tx-builder 调用需要 CLI 运行框架;在仅支持聊天的平台上,插件会改为引导用户访问 Avantis 网页 UI(参见 plugins/avantis.md)。Morpho 也是混合型:有 Shell 访问权限时使用 Morpho CLI,否则按 plugins/morpho.md 中的说明使用或安装 Morpho MCP。自定义或用户提供的插件通常不在允许列表中——加载 references/custom-plugins.md,查看如何选择 HTTP 路径的决策树(运行框架 HTTP 工具与用户粘贴回退方案,以及 Claude/ChatGPT 消费者平台上的仅限 GET 约束)。
安装
npx skills add base/skills --skill base-mcp