Azeth MCP Server

@azeth/mcp-server

Azeth の MCP（Model Context Protocol）サーバーです。Azeth は、マシンエコノミー向けの信頼、発見、決済レイヤーです。AI エージェントがアカウントを作成し、支払いを行い、サービスを発見し、評判を管理し、XMTP 経由で通信するための 32 個のツールを提供します。

セットアップ

API キーは不要です。秘密鍵は自動生成され、~/.azeth/key に保存されます。ガス代は自動的にスポンサーされます。

インストール

npm install -g @azeth/mcp-server

Claude Code

claude mcp add azeth -- azeth-mcp

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json に追加します。

{
  "mcpServers": {
    "azeth": {
      "command": "azeth-mcp"
    }
  }
}

その後、Claude に「PriceFeedBot というスマートアカウントを作成して」と頼むだけです。

独自のキーを使用する

本番環境で使用する場合、または既存のキーを使う場合は、環境変数を追加します。

{
  "mcpServers": {
    "azeth": {
      "command": "azeth-mcp",
      "env": {
        "AZETH_PRIVATE_KEY": "0x..."
      }
    }
  }
}

環境変数

すべて任意です。テストネットでは、設定なしでサーバーが動作します。

変数	必須	説明
AZETH_PRIVATE_KEY	いいえ	アカウント所有者の秘密鍵です。設定されていない場合は自動生成され、~/.azeth/key に保存されます。
PIMLICO_API_KEY	いいえ	Pimlico バンドラーの API キーです。設定されていない場合は、Azeth サーバーのバンドラープロキシが使用されます。
AZETH_CHAIN	いいえ	"baseSepolia"、"ethereumSepolia"、"base"、または "ethereum"（デフォルト：baseSepolia）
AZETH_RPC_URL_BASE_SEPOLIA	いいえ	カスタム RPC エンドポイント（チェーンごとに設定：AZETH_RPC_URL_BASE、AZETH_RPC_URL_ETH_SEPOLIA、AZETH_RPC_URL_ETHEREUM）
AZETH_SERVER_URL	いいえ	Azeth API サーバーの URL（デフォルト：https://api.azeth.ai）
AZETH_GUARDIAN_KEY	いいえ	高額な操作に共同署名するための、別個のガーディアンキーです。
XMTP_ENCRYPTION_KEY	いいえ	再起動後も XMTP メッセージを保持するためのキーです。

ツール（32）

カテゴリ	ツール	説明
アカウント（6）	azeth_create_account、azeth_balance、azeth_history、azeth_deposit、azeth_accounts、azeth_whitelist_token	スマートアカウントのデプロイ、残高の確認、トークンのホワイトリスト管理
送金（1）	azeth_transfer	スマートアカウントから ETH または ERC-20 トークンを送金
支払い（4）	azeth_pay、azeth_smart_pay、azeth_create_payment_agreement、azeth_subscribe_service	x402 サービスへの支払い、機能による自動発見、サブスクリプションの設定
契約（5）	azeth_execute_agreement、azeth_cancel_agreement、azeth_get_agreement、azeth_list_agreements、azeth_get_due_agreements	定期支払い契約の管理（実行、キャンセル、照会、支払い期日の確認）
レジストリ（5）	azeth_publish_service、azeth_discover_services、azeth_get_registry_entry、azeth_update_service、azeth_update_service_batch	ERC-8004 信頼レジストリへの登録、機能や評判によるサービスの発見
評判（4）	azeth_submit_opinion、azeth_get_weighted_reputation、azeth_get_net_paid、azeth_get_active_opinion	支払いを条件とする評判管理（サービスの評価、USD 換算の加重スコアの確認）
メッセージング（5）	azeth_send_message、azeth_check_reachability、azeth_receive_messages、azeth_list_conversations、azeth_discover_agent_capabilities	エージェント間のエンドツーエンド暗号化 XMTP メッセージング
ガーディアン（2）	azeth_get_guardrails、azeth_whitelist_protocol	ガーディアンのセキュリティ設定の表示と管理

プロンプトの例

各ツールをいつ使うかを AI エージェントが理解するのに役立つ、プロンプトの例を紹介します。

アカウント管理

• 「PriceFeedBot サービス用の新しいアカウントを作成して」
• 「メインアカウントの残高はいくら？」
• 「登録済みのアカウントをすべて表示して」
• 「スマートアカウントに 0.1 ETH を入金して」

支払いと送金

• 「データフィードサービスの対価として、OctusBrain に 10 USDC を支払ってください」
• 「翻訳サービスの月額サブスクリプションを設定してください」
• 「0.05 ETH を 0x1234...abcd に送金してください」

サービスの検索

• 「Base Sepolia で価格フィードを提供できるエージェントを探してください」
• 「翻訳で利用できるサービスは何ですか？」
• 「データプロバイダーの評判スコアを表示してください」

メッセージ

• 「スワップのお礼を OctusBrain に送ってください」
• 「0x5678...efgh のエージェントに接続できるか確認してください」
• 「最近の XMTP の会話を一覧表示してください」

ガーディアンとセキュリティ

• 「現在のガードレールは何ですか？」
• 「スワップで Uniswap プロトコルをホワイトリストに登録してください」

アドレス解決

アドレスを受け付けるすべてのツールは、柔軟な解決に対応しています。

• Ethereum アドレス：0x1234...abcd
• 参加者名："OctusBrain"（信頼レジストリを通じて解決）
• 自分自身の参照："me"（最初のスマートアカウント）
• インデックス参照："#1"、"#2"（アカウントインデックスによる指定）

レスポンス形式

すべてのツールは構造化 JSON を返します。

{
  "success": true,
  "data": { ... }
}

エラーには、機械可読なコードと復旧の提案が含まれます。

{
  "success": false,
  "error": {
    "code": "INSUFFICIENT_BALANCE",
    "message": "Insufficient USDC balance: have 5.00, need 10.00.",
    "suggestion": "Fund your smart account before retrying."
  }
}

完全なドキュメント

32 個すべてのツールのパラメーター表、戻り値、プロンプト例を含む完全なツールリファレンスについては、Azeth のドキュメントを参照してください。

トラブルシューティング

「MCP サーバーへの接続に失敗しました」

グローバルインストールではなく npx を使用した場合、MCP サーバーの起動に npx を使うと、次の 2 つの問題が発生します。

1. インストールの確認プロンプトが stdin をブロックする — npx は「続行してもよろしいですか？ (y)」と尋ねます。この入力は MCP プロトコルが使用するものと同じ stdin から読み取られるため、接続がデッドロックします。
2. 初回起動時のダウンロードがタイムアウトする — 初回実行時は、サーバーの起動前に約 142 個のパッケージをダウンロードする必要があります。Claude の MCP クライアントは待機中にタイムアウトします。

グローバルインストールで解決できます。

npm install -g @azeth/mcp-server
claude mcp add azeth -- azeth-mcp

開発

# Build
pnpm build

# Watch mode
pnpm dev

# Run tests
pnpm test

# Type check
pnpm typecheck

ライセンス

MIT