MCP Wallet Signer

🚀 MCP錢包簽名器

MCP錢包簽名器可確保您的私鑰不會離開瀏覽器，每筆交易都需在錢包中獲得用戶明確批准。它改變了傳統區塊鏈MCP需將私鑰粘貼到配置文件的方式，通過EIP - 6963將交易路由到瀏覽器錢包，讓您像與其他dapp交互一樣審查和批准每個操作，避免配置文件中私鑰的風險和靜默交易。

🚀 快速開始

本項目與任何支持MCP的客戶端通過標準輸入輸出傳輸方式兼容。

✨ 主要特性

• 私鑰安全：私鑰不會離開瀏覽器，每筆交易都需用戶明確批准。
• 安全交易：通過EIP - 6963將交易路由到瀏覽器錢包，避免配置文件中私鑰的風險和靜默交易。
• 多工具支持：提供如連接錢包、發送交易、簽署消息等多種MCP工具。
• 多鏈支持：內置多個區塊鏈網絡的RPC URL。

📦 安裝指南

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智能鏈 (56)

配置

可通過以下環境變量進行配置（可選）：

開發

需要 Deno v2.0+。

# 安裝依賴
deno install
cd web && deno install && cd ..

# 在開發模式下運行MCP服務器
deno task dev

# 運行Web UI開發服務器（在單獨的終端中）
deno task dev:web

# 運行測試
deno task test

# 構建Web 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 # 基於Promise的請求跟蹤
│   ├── 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輸出 + 構建的Web資產

構建流程

deno task build:npm 運行 scripts/build-npm.ts，該腳本執行以下操作：

1. 通過dnt將 src/ 轉換為ES模塊JavaScript → npm/esm/。
2. 從 deno.jsonc 中的元數據生成 npm/package.json。
3. 構建Svelte Web UI (web/ → web/dist/)。
4. 將Web資產複製到 npm/web/。

開發工作流程

deno task dev        # 直接使用Deno運行MCP服務器
deno task dev:web    # Web UI的Vite開發服務器（在單獨的終端中）
deno task test       # 單元 + 端到端API測試
deno task check      # 類型檢查 + 代碼檢查 + 格式化檢查

📄 許可證

本項目採用MIT許可證。