base-mcp-legacy
基于MCP协议连接AI Agent与Base链的早期工具包，已归档废弃，官方已迁移至新版AgentK
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
微信扫码咨询客服
POMOAI — 让开源 AI 即刻运行
基于MCP协议连接AI Agent与Base链的早期工具包，已归档废弃，官方已迁移至新版AgentK
加载项目详情…
本应用为开源项目，仅供学习研究，请遵守其开源协议。
2024 年上半年，当大语言模型开始在各行各业疯狂渗透的时候，一个问题困扰着区块链开发者：如何让 AI Agent 安全地与链上资产交互？ 直接把私钥交给 LLM 无异于裸奔，而完全不介入链上操作又让 AI 的自动化能力大打折扣。Coinbase 团队在此时推出了 base-mcp，用 Model Context Protocol（MCP）这把"中间层钥匙"，试图在 AI Agent 的灵活性与资产安全之间找到平衡点。
base-mcp 的核心思路是：AI Agent 不直接操作私钥，而是通过 MCP 协议调用 Coinbase AgentKit 提供的 Action Provider，由 SDK 在后端完成交易签名。整个链路中，LLM 只会接触到抽象的工具接口（如 transferETH、deployERC20），而敏感的密钥信息始终被隔离在 AgentKit 层——这像极了企业里"人机协同"的权限管控机制：AI 负责决策，人类负责审批。
base-mcp 本质上是一个 Node.js/TypeScript 实现的 MCP Server，通过 @modelcontextprotocol/sdk 构建。架构分为三层：
传输层：采用 StdioServerTransport，MCP Server 通过标准输入/输出与 Claude CLI（或任何兼容 MCP 的客户端）通信。这种设计天然契合命令行工具，无需额外 HTTP 服务进程，非常轻量。
工具层：每个功能域对应一个独立 Action Provider，全部挂载到 AgentKit 中：
| Provider | 路径 | 功能 |
|---|---|---|
basenameActionProvider | src/tools/ | Base Name Service 域名管理 |
cdpWalletActionProvider | @coinbase/agentkit | 钱包操作（地址查询、余额、领取测试币） |
cdpApiActionProvider | @coinbase/agentkit | Coinbase API 底层调用 |
baseMcpErc20ActionProvider | src/tools/erc20/ | ERC-20 代币转账、部署 |
baseMcpNftActionProvider | src/tools/nft/ | NFT 铸造、转移 |
baseMcpMorphoActionProvider | src/tools/morpho/ | Morpho DeFi 借贷协议交互 |
baseMcpOnrampActionProvider | src/tools/onramp/ | 法币入口（银行卡买币） |
openRouterActionProvider | src/tools/open-router/ | OpenRouter LLM 路由 |
这种插件化架构的亮点在于：每个 Provider 独立注册工具、声明所需环境变量（通过 getActionProvidersWithRequiredEnvVars 统一收集），最后在 main.ts 中统一挂载到 AgentKit 实例。新增一种链上操作，只需新建 Provider 目录，无需改动核心逻辑。
钱包层：由 CdpWalletProvider 封装，支持两种初始化方式：
SEED_PHRASE：完全控制钱包，可执行写操作viem/accounts）：仅读模式，适合 AI 分析场景环境变量兼容旧版和新版 Coinbase API Key 名称（COINBASE_API_KEY_NAME / COINBASE_API_KEY_ID），体现了对历史兼容性的重视。
场景一：钱包管理。 AI Agent 可以查询任意 Base 链地址的 ETH 和代币余额，还能自动领取 Base Sepolia 测试网 ETH——这对 AI 自动化测试场景非常有价值。
场景二：ERC-20 代币交互。 只需提供代币名称、符号和小数位，AI 就能一键部署标准 ERC-20 合约。这降低了区块链应用开发的门槛，让 AI 可以自动生成 Token。
场景三：DeFi 借贷。 通过 Morpho Provider，AI Agent 可以代表用户执行借贷操作，无需第三方介入。想象一下：AI 监测到某用户的 ETH 存款利率下降，自动将资产迁移到 Morpho 收益更高的池子。
场景四：法币入口。 Onramp Provider 让 AI 可以在对话中引导用户完成银行卡买币流程，打通了 Web2 到 Web3 资金流入的最后一公里。
在分析过程中发现，base-mcp 已在 2024 年底被官方归档（Archived），npm 包直接指向一个 deprecated.js 警告脚本——任何安装或执行都会立即打印醒目警告并退出。
废弃原因推测：Coinbase 推出了更完善的替代方案：
这说明 base-mcp 本质上是 Coinbase 在 MCP 协议早期的一个实验性实现，随着 AgentKit 的成熟和 MCP 协议的标准化，官方选择了更统一的路径。
| 维度 | 评分 | 说明 |
|---|---|---|
| 代码质量 | 8/10 | TypeScript 严格模式，完整的类型定义，错误处理完善（uncaughtException/unhandledRejection 均有捕获） |
| 文档质量 | 8/10 | README 结构清晰，每个 Provider 有独立文档，但项目归档后文档停止更新 |
| 测试覆盖 | 未知 | 仓库中未发现测试文件 |
| 安全设计 | 9/10 | AgentKit 钱包抽象层设计优秀，私钥从不暴露给 LLM，支持只读模式 |
| 架构设计 | 9/10 | Provider 插件体系清晰，职责边界明确，可扩展性强 |
base-mcp 是一款纯 CLI 工具，不支持 Docker 容器化，也没有 docker-compose 配置。部署流程极为简单：
# 方式1：全局安装
npm install -g @coinbase/mcp
# 方式2：直接运行（npx）
npx @coinbase/mcp
# 初始化配置
npx @coinbase/mcp --init
安装后需配置环境变量：
export COINBASE_API_KEY_ID=your_api_key_id
export COINBASE_API_SECRET=your_api_secret
硬件需求极低：无需 GPU，内存占用 < 512MB，磁盘 < 100MB，普通开发机即可运行。
base-mcp 最重要的价值不在于它本身，而在于它验证了一个方向：AI Agent 与区块链的交互应该通过标准化协议完成，而不是各自为政的私有 API。MCP 作为 Anthropic 主导的开放协议天然适合这一场景——它定义了 AI 工具调用的"通用语法"，而 base-mcp 则为这条语法添加了 Web3 的语义层。
虽然 base-mcp 已被归档，但它播下的种子在 Base 官方后续的 AI Agent 文档体系中得到了延续。可以预见，随着 MCP 协议的普及，会有更多链上操作被标准化为 MCP Tools，AI 与 DeFi、DAO 的深度结合只是时间问题。