MCP Wallet Signer

🚀 MCP Wallet Signer

あなたの秘密鍵は決してブラウザを離れません。 すべてのトランザクションは、ウォレットで明示的なユーザーの承認を必要とします。

ほとんどのブロックチェーンMCPでは、設定ファイルに秘密鍵を貼り付ける必要があります。これにより、AIエージェントがあなたの資金に完全かつ無監督でアクセスできるようになります。MCP Wallet Signerは異なるアプローチを取ります。EIP - 6963を介して、すべてのトランザクションを実際のブラウザウォレット（MetaMask、Rabbyなど）にルーティングします。そのため、他のdappとのやり取りと同じように、各アクションをレビューして承認できます。設定ファイルに鍵を入れる必要がなく、暗黙的なトランザクションのリスクもありません。

互換性

stdioトランスポートを介して、すべてのMCP互換クライアントで動作します。

🚀 クイックスタート

📦 インストール

Claude Code CLI

claude mcp add evm-wallet -- npx -y mcp-wallet-signer

Claude Desktop

claude_desktop_config.jsonに以下を追加します。

{
  "mcpServers": {
    "evm-wallet": {
      "command": "npx",
      "args": ["-y", "mcp-wallet-signer"]
    }
  }
}

直接実行

npx -y mcp-wallet-signer
pnpx mcp-wallet-signer
bunx mcp-wallet-signer

✨ 主な機能

MCPツール

動作原理

1. エージェントがMCPツール（例：send_transaction）を呼び出します。
2. サーバーがブラウザをローカルの署名ページに開きます。
3. ユーザーがウォレットを接続し、アクションを承認します。
4. 結果（アドレス、トランザクションハッシュ、署名）がエージェントに返されます。

サポートされるチェーン

以下のチェーンの組み込みRPC URLがあります。

• イーサリアム (1)
• Sepolia (11155111)
• ポリゴン (137)
• Arbitrum One (42161)
• Optimism (10)
• Base (8453)
• アバランチェ (43114)
• BNB Smart Chain (56)

設定

環境変数（オプション）：

🔧 技術詳細

開発

Deno v2.0以上が必要です。

# 依存関係のインストール
deno install
cd web && deno install && cd ..

# 開発モードでMCPサーバーを実行
deno task dev

# ウェブUIの開発サーバーを実行（別のターミナル）
deno task dev:web

# テストを実行
deno task test

# ウェブUIをビルド
deno task build:web

# npm用にビルド
deno task build:npm

# コードをフォーマット
deno task fmt

# コードをリント
deno task lint

プロジェクト構造

Denoで開発され、dntを介してnpmに公開されています。src/のソースはnode:の組み込みを使用しているため（Deno固有のAPIは使用していません）、npmバンドルはNode.jsで実行できます。

deno.jsonc              # Denoの設定 + npmパッケージのメタデータ（バージョンの唯一の情報源）
server.json             # MCPレジストリのマニフェスト（LobeHubなどがgitから読み取る）
scripts/build-npm.ts    # dntのビルド：deno.jsoncを読み取り、src/ → npm/に変換
├── src/                # サーバーのソース（TypeScript、DenoとNodeの両方で実行）
│   ├── index.ts        # CLIのエントリポイント
│   ├── mcp-server.ts   # MCPツールの定義
│   ├── http-server.ts  # ブラウザ承認UI用の遅延起動HTTPサーバー
│   ├── wallet-signer.ts # コアの署名オーケストレーション
│   ├── pending-store.ts # プロミスベースのリクエストトラッキング
│   ├── schemas.ts      # MCPツールの入力用のZodスキーマ
│   ├── transport.ts    # viemのカスタムトランスポート
│   ├── viem-account.ts # viemのローカルアカウントアダプター
│   ├── mod.ts          # ライブラリのエクスポート（npm: "mcp-wallet-signer"）
│   ├── wallet-only.ts  # ライブラリのエクスポート（npm: "mcp-wallet-signer/wallet-only"）
│   └── version.ts      # 実行時にpackage.jsonからバージョンを読み取る
├── web/                # Svelte UI（ウォレット承認ページ）
│   └── src/
│       ├── App.svelte
│       └── components/ # ConnectWallet, TransactionSigner, MessageSigner
├── tests/
│   ├── *.test.ts       # 単体テスト
│   ├── e2e/            # エンドツーエンドテスト（HTTP API）
│   └── e2e-browser/    # エンドツーエンドテスト（Playwright、実際のブラウザウォレット）
└── npm/                # 生成された — dntの出力 + ビルドされたウェブアセット

ビルドパイプライン

deno task build:npmはscripts/build-npm.tsを実行し、以下のことを行います。

1. dntを介してsrc/をESM JavaScriptに変換 → npm/esm/
2. deno.jsoncのメタデータからnpm/package.jsonを生成
3. SvelteのウェブUIをビルド（web/ → web/dist/）
4. ウェブアセットをnpm/web/にコピー

開発ワークフロー

deno task dev        # Denoで直接MCPサーバーを実行
deno task dev:web    # ウェブUIのVite開発サーバー（別のターミナル）
deno task test       # 単体 + エンドツーエンドAPIテスト
deno task check      # 型チェック + リント + フォーマットチェック

📄 ライセンス

MIT