8004swap-mcp

@stakemate/8004swap-mcp-server

8004Swap を MCP ツールとして公開するため、MCP 対応エージェント（Claude、またはその他の MCP クライアント）が、人間が UI を操作することなく、直接見積もりを依頼し、取引を決済し、Registry のステータスを確認できます。

@stakemate/8004swap-agent-sdk の薄いラッパーです。実際にワイヤー上で何が行われるかについては、../PROTOCOL.md を参照してください。

ツール

• check_agent_status — 読み取り専用で、鍵は不要です。アドレスが 8004Swap Registry に登録済みで、アクティブかどうかを確認します。
• register_agent — Registry への一度限りの自己登録です。AGENT_PRIVATE_KEY を使ってトランザクションに署名し、ブロードキャストします。
• request_quote — テイカーとして動作します。Relay 経由で RFQ をブロードキャストし、購読中のメイカーから署名済み見積もりを返します。Relay で認証するために AGENT_PRIVATE_KEY が必要です（この手順にガス代はかかりません。オフチェーンのログイン署名です）。
• fill_quote — テイカーとして動作します。request_quote が返した見積もりを、オンチェーンで Settlement.fillQuote（または permit を渡した場合は fillQuoteWithPermit）を介して決済します。トランザクションに署名し、ブロードキャストします。
• pay_x402 — 設定済みエージェントの資金を使って、任意の x402 で保護された HTTP リソース（プロトコル v2）の支払いを行います。URL にアクセスし、支払い要件を示す 402 が返された場合は、EIP-3009 transferWithAuthorization に署名して再試行します。サポートされるのは eip3009 送金方式を使用する exact スキームのみです（USDC のようなトークンで一般的なケースです）。Permit2／ERC-7710 のオファーは拒否されます。8004Swap 独自のプロトコルに限定されません。これは、fill_quote で USDC に交換したエージェントが、その資金で別のエージェントの x402 で保護されたサービスに支払う方法です。すべての呼び出しで maxAmountAtomic が必須で、これが唯一の支出上限です。その呼び出しで承認してもよい最大額を必ず設定してください。

現時点では、メイカーとして動作するツール（ペアを購読し、ブロードキャストに応答する機能）はありません。この役割には、受信する RFQ に反応する長時間接続が必要で、MCP のリクエスト／レスポンス型ツール呼び出しモデルには適していないためです。現時点では、この役割には sdk/relay/examples/makerClient.ts を直接使用してください。

セットアップ

npm install
npm run build
cp .env.example .env   # fill in AGENT_PRIVATE_KEY if you want to sign anything

.env.example のデフォルト値は現在の Base Sepolia デプロイメントを参照しています。別のネットワークが利用可能になったら、RPC_URL／CHAIN_ID／REGISTRY_ADDRESS／SETTLEMENT_ADDRESS／RELAY_URL を上書きしてください。

AGENT_PRIVATE_KEY が必要なのは、register_agent、request_quote、fill_quote のみです。 このエージェント専用のウォレットを生成してください。テストネット外の資金を保有する鍵を指定してはいけません。鍵のローテーションやスコープ制限の機能は組み込まれていません。この環境変数を持つ人は誰でも、そのアドレスとして署名できます。

実行

スタンドアロンの stdio MCP サーバーとして実行する場合：

npm start

Claude Desktop の claude_desktop_config.json などで、MCP クライアントからこのサーバーを指定してください：

{
  "mcpServers": {
    "8004swap": {
      "command": "node",
      "args": ["/absolute/path/to/8004swap/mcp-server/dist/index.js"],
      "env": {
        "AGENT_PRIVATE_KEY": "0x..."
      }
    }
  }
}

ステータス

リポジトリの他の部分と同様に、テストネット専用です。正式な監査は行われていません。fill_quote と register_agent は実際の（テストネット上の）トランザクションをブロードキャストします。ドライランモードはありません。