MCP Wallet Signer

MCP Wallet Signer是一个安全的区块链钱包签名工具，通过浏览器钱包（如MetaMask）进行交易审批，确保私钥永不离开浏览器，为AI代理提供安全的EVM链交互能力。

金融开发者工具 #钱包安全 #交易签名 #MCP工具 #区块链交互 .TypeScript

评分 : 2分

下载量 : 6.3K

更新时间 : 2026-03-13

打开站点

什么是MCP Wallet Signer？

MCP Wallet Signer是一个Model Context Protocol（MCP）服务器，专门用于安全地处理以太坊虚拟机（EVM）区块链上的交易签名。与传统的MCP工具不同，它不会要求您将私钥粘贴到配置文件中，而是通过浏览器钱包（如MetaMask、Rabby等）进行签名，确保每笔交易都需要您的明确批准。

如何使用MCP Wallet Signer？

当AI助手需要执行区块链操作时（如发送交易、签名消息），MCP Wallet Signer会自动在您的浏览器中打开一个本地页面，您可以在那里连接钱包并批准操作。操作完成后，结果会返回给AI助手继续处理。

适用场景

适用于需要AI助手协助处理区块链操作但又不希望暴露私钥的场景，例如：让AI助手帮助发送代币、与智能合约交互、签名验证消息等，同时保持对资金的安全控制。

主要功能

安全钱包连接

通过EIP-6963标准连接浏览器钱包，私钥永不离开您的浏览器，确保最高级别的安全性。

交易签名

发送ETH、代币或调用智能合约，所有交易都需要在您的钱包中明确批准。

消息签名

支持个人消息签名（personal_sign）和EIP-712结构化数据签名，用于身份验证等场景。

余额查询

通过RPC节点查询ETH余额，无需钱包连接即可获取账户信息。

多链支持

内置支持以太坊、Polygon、Arbitrum、Optimism、Base、Avalanche、BNB Chain等主流区块链网络。

多客户端兼容

支持Claude Desktop、Claude Code、Cursor、Windsurf等所有MCP兼容客户端。

优势

极致安全：私钥永不离开您的浏览器，每笔交易都需要手动批准

无需配置私钥：不需要在配置文件中粘贴私钥，避免泄露风险

用户友好：使用熟悉的浏览器钱包界面进行操作

兼容性好：支持所有EIP-6963兼容的钱包（MetaMask、Rabby等）

多链支持：覆盖主流EVM区块链网络

局限性

需要浏览器交互：每次操作都需要在浏览器中手动批准

无法自动化：不适合需要完全自动化执行的场景

依赖钱包连接：需要安装并配置浏览器钱包扩展

网络依赖：需要稳定的网络连接来访问RPC节点

如何使用

安装MCP Wallet Signer

根据您使用的客户端选择相应的安装方式。

配置客户端

将MCP Wallet Signer添加到您的MCP客户端配置中。

启动并使用

启动您的AI助手客户端，当需要区块链操作时，会自动打开浏览器页面让您连接钱包并批准操作。

环境配置（可选）

可以通过环境变量配置服务器端口和默认链ID。

使用案例

发送ETH给朋友

让AI助手帮助您向朋友的地址发送一定数量的ETH。

签名登录验证消息

让AI助手帮助您签名一个用于网站登录验证的消息。

查询账户余额

让AI助手帮助您查询某个地址的ETH余额。

与DeFi合约交互

让AI助手帮助您调用一个DeFi智能合约，例如进行代币兑换。

常见问题

MCP Wallet Signer安全吗？

支持哪些钱包？

需要安装Node.js吗？

支持哪些区块链？

可以自动化执行交易吗？

如何更改默认的RPC节点？

支持批量交易吗？

如果浏览器页面没有自动打开怎么办？

🚀 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工具使用示例：

工具	描述	是否需要浏览器
`connect_wallet`	连接钱包，返回地址	是
`send_transaction`	发送ETH/代币，调用合约	是
`sign_message`	签署任意消息 (personal_sign)	是
`sign_typed_data`	签署EIP - 712类型数据	是
`get_balance`	读取ETH余额 (通过RPC)	否

高级用法

工作流程

代理调用MCP工具（例如 send_transaction）。
服务器在浏览器中打开本地签名页面。
用户连接钱包并批准操作。
将结果（地址、交易哈希、签名）返回给代理。

📚 详细文档

支持的链

内置以下区块链网络的RPC URL：

以太坊 (1)
Sepolia (11155111)
多边形 (137)
Arbitrum One (42161)
Optimism (10)
Base (8453)
雪崩 (43114)
BNB智能链 (56)

配置

可通过以下环境变量进行配置（可选）：

变量	描述	默认值
`EVM_MCP_PORT`	HTTP服务器端口	3847
`EVM_MCP_DEFAULT_CHAIN`	默认链ID	1

开发

需要 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，该脚本执行以下操作：

通过dnt将 src/ 转换为ES模块JavaScript → npm/esm/。
从 deno.jsonc 中的元数据生成 npm/package.json。
构建Svelte Web UI (web/ → web/dist/)。
将Web资产复制到 npm/web/。

开发工作流程

deno task dev        # 直接使用Deno运行MCP服务器
deno task dev:web    # Web UI的Vite开发服务器（在单独的终端中）
deno task test       # 单元 + 端到端API测试
deno task check      # 类型检查 + 代码检查 + 格式化检查