mcpField
B
base-mcp

base-mcp

github.com/base其他120504 次安装1 天前更新
代码仓库

关于 base-mcp

base-mcp 是指导 Agent 使用 Base MCP 的技能,现已更名为 wallet-mcp。它涵盖钱包操作、第三方插件路由及交易审批注意事项。

主要功能

  1. 01钱包余额、转账与兑换
  2. 02签名、x402 支付和合约调用
  3. 03第三方插件选择与操作指引
  4. 04交易审批及风险提示

适用场景

  1. 01查询 Base Account 钱包能力
  2. 02按指定平台执行链上操作
  3. 03处理需要批准的写入交易

MCP 相关

该技能指导 Agent 检测并使用 Base MCP 暴露的工具,并按需加载操作参考和插件说明。

安装

复制下面的命令,在终端中运行。

$npx skills add https://github.com/base/skills --skill base-mcp

安装后在 Claude Code 中输入/base-mcp确认已加载。

包含的文件

除 SKILL.md 外,安装时一起下载的参考资料和脚本。

README.md
plugins/
aerodrome.md
avantis.md
balancer.md
bankr.md
bitrefill.md
brickken.md
clawnch.md
flaunch.md
gmgn.md
hydrex.md
kyberswap.md
moonwell.md
morpho.md
o1-exchange.md
opensea.md
printr.md
uniswap.md
venice.md
virtuals.md
yo.md
references/
approval-mode.md
batch-calls.md
custom-plugins.md
install.md
plugin-spec.md
tone.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 获取相同的相对路径。此文件中其他所有参考文件和插件链接也适用相同的备用方式(见下方“加载引用文件”)。

入门说明

保持简短。每个会话开始时、开始实际工作前执行一次:

  1. 简要说明可用功能——用一两句话说明。用户拥有 Base Account 钱包,可以进行余额查询、代币发送和兑换、消息签名、x402 支付、合约调用批处理,以及(如果已安装)使用第三方插件进行 DeFi、兑换和其他链上操作。不要逐一列出所有工具——Agent 会直接从 MCP 发现工具和插件。

  2. 继续操作前,逐字显示以下免责声明:

    使用 Base MCP 即表示你同意 Base Account and Base App 服务条款。Base MCP 提供对第三方构建的插件的访问,这些插件并非由 Base 构建。Base 不运营、认可或审计这些插件,也不对你交互的协议负责。交易不可撤销——批准前请务必仔细检查。

  3. 钱包地址和余额为可选信息——仅在用户提出要求,或待处理操作确实需要地址时(例如写入调用、查询持仓),才获取并显示。不要一开始就主动提供钱包详情。

工具

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

评论

支持 Markdown