Base Web3 Action Mcp Server

Base Web3 Action MCP 服务 🛠️🚀

一款轻量、零配置的 Base L2 Network Model Context Protocol（MCP）服务。此服务为 AI Agent（如 Cursor、Windsurf、Zed 或 Claude Desktop）提供标准 EVM 工具，用于查询余额、解析 Basename，以及构建可自动获取排序器费用奖励的交易载荷。

---

功能

• 无需 API 密钥： 开箱即用，使用轮换的公共 RPC 端点，并内置故障转移机制，避免触发速率限制错误（429）。
• 链上 Basename 解析器： 使用 Base L2 合约直接在链上解析 .base 域名（例如，jesse.base -> jesse.base.eth），绕过速度较慢的 L1 网关。
• ERC-8021 后缀追加器： 自动编码并将你的 Builder Code 后缀追加到所有生成的交易载荷中，从而被动归属排序器奖励。
• 代币与 NFT 部署工具： 只需单击一次，即可构建并生成经过优化的标准 ERC-20 代币和 ERC-721 NFT 集合的部署载荷。
• 自行托管资产： 绝不会处理、请求或存储私钥。它只会构建未签名的交易载荷，供客户端审查、签名和广播。

---

可用工具

1. get_balance：查询 Base（主网或 Sepolia）上的原生 ETH 或 ERC-20 代币余额。
2. resolve_basename：将任意 .base 域名解析为 EVM 十六进制地址。
3. build_transfer：为 ETH 或 ERC-20 构建未签名的转账交易载荷。
4. build_swap：在 Base 上构建 Uniswap V3 兑换载荷（例如，将 ETH 兑换为 USDC）。
5. build_deploy_contract：为自定义字节码构建合约部署载荷。
6. build_deploy_token：部署标准 ERC-20 代币合约。
7. build_deploy_nft：部署标准 ERC-721 NFT 集合合约。

---

安装与设置

本地客户端设置（stdio）

1. Claude Desktop

将以下内容添加到你的 claude_desktop_config.json（macOS 上位于 ~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "base-web3": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-server/index.js"],
      "env": {
        "BASE_BUILDER_CODE": "bc_3nsmabm6"
      }
    }
  }
}

2. Cursor 设置

1. 前往 Settings > Models > MCP。
2. 点击 + Add New MCP Server。
3. 配置：
   • 名称： Base Web3 Action
   • 类型： stdio
   • 命令： node /absolute/path/to/mcp-server/index.js

3. Smithery（推荐）

使用 Smithery CLI 将服务直接安装到 Claude Desktop：

npx -y @smithery/cli@latest install base-web3-mcp --client claude

对于 Cursor，请按照上文所示将其配置为标准 stdio 服务。

---

远程 API 设置（无状态 HTTP）

作为无状态的身份验证端点提供服务，供网站、机器人和 Farcaster 帧使用：

• 端点： https://your-worker-subdomain.workers.dev/mcp
• 请求头： Authorization: Bearer <EXECUTION_SECRET>
• 请求正文（JSON-RPC 2.0）：

  {
    "method": "tools/call",
    "params": {
      "name": "get_balance",
      "arguments": {
        "address": "0x179A862703a4adfb29896552DF9e307980D19285"
      }
    }
  }
  

---

许可证

MIT - 开源。为 Base 构建者生态系统打造。