Base Web3 Action Mcp Server

Base Web3 アクション MCP サーバー 🛠️🚀

Base L2 Network 用の軽量で設定不要な Model Context Protocol（MCP）サーバーです。このサーバーは、Cursor、Windsurf、Zed、Claude Desktop などの AI エージェントに標準的な 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 の 16 進数アドレスに解決します。
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. 以下のように設定します。
   • Name: Base Web3 Action
   • Type: stdio
   • Command: 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 ビルダーエコシステム向けに作成されました。