设置 MCP

为 Cursor、Claude Code、ChatGPT 及其他 MCP 客户端安装并配置 IronWallet MCP 服务器。

IronWallet MCP 服务器 (@ironwallet/mcp-server) 为您的 AI 智能体在计算机上提供了一个非托管加密钱包。助记词在本地生成并加密,它们绝不会离开这台机器,也不会经过智能体、大语言模型或 IronWallet 后端。智能体可以查看余额、显示存款二维码、转账代币,以及在 12 个网络上进行兑换:Ethereum、BSC、Polygon、Base、Arbitrum、Optimism、Avalanche、Tron、Bitcoin、Solana、XRP 和 TON。

目前没有每笔交易的确认界面——一旦您要求智能体发送或兑换,它无需再次询问即可签名并广播。请使用余额有限的专用热钱包,切勿使用您的主钱包。

要求:Node.js 20+ (npx)。仅限桌面端 / stdio。

功能

非托管,本地签名

助记词在主机上保持加密状态(仅限所有者文件权限)。交易在本地机器上签名;没有任何工具会接收或返回助记词。

本地浏览器中的钱包

使用 create_wallets 创建钱包(返回 backup_url),或通过 open_wallet_manager 导入和备份——这是一个仅限环回地址 127.0.0.1 的页面,在 15 分钟不活动后会自动关闭。机密仅出现在该浏览器页面中,绝不会出现在聊天记录中。

带费用估算的转账

estimate_transfer 可在广播前预览费用;send_transfer 在本地签名并发送;get_operation_status 用于轮询结果。服务器可能会略微减少金额以确保费用在余额范围内——响应会说明何时发生这种情况。

目录驱动的兑换

list_swap_networks 和 list_swap_assets 提供买入/卖出目录,因此智能体永远不会凭空捏造代币地址。estimate_swap 提供报价,execute_swap 基于最新报价执行,get_swap_status 用于轮询。

存款二维码

get_deposit_qr 返回用于聊天的 PNG 图片以及本地 qr_url 后备链接。

可选的支出限额

通过 set_wallet_policy 设置每个钱包的策略:readOnly(只读)、maxPerTxUsd(单笔交易最大美元金额)以及转账接收者白名单。默认关闭;适用于发送和兑换操作。IW_READ_ONLY=true 可使整个服务器变为只读。

安装

选项 1:npx (推荐)

使用 npx 运行服务器,无需全局安装。这确保您始终使用最新版本。

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

首次启动可能需要约 30 秒来安装依赖项。如果您的 MCP 客户端超时,请在终端中运行一次该命令以预热缓存,然后重新连接。

选项 2:全局安装

全局安装该包以加快启动速度,然后运行 ironwallet-mcp。

npm install -g @ironwallet/mcp-server@latest

设置指南

仅适用于桌面端

每个客户端都有一个专用的静态 URL(例如 /ai/introduction/vscode/)。下方所有的安装命令也已内嵌在本页中——无需标签页,没有任何隐藏内容。

Cursor

最推荐

最推荐

适用于免费版,安装简单,体验最佳

在 Cursor 中打开

安装一次即可。之后,钱包工具将在每次聊天中可用。您也可以将其粘贴到 ~/.cursor/mcp.json 中并重启 Cursor。

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

安装后重新加载 Cursor,以便 PATH 包含 npx。

独立页面,用于 Cursor — 一次 HTTP 获取仅返回此指南。

Claude Code

需要更高专家水平

在代码模式下运行良好,聊天模式非常有限

在 Claude Code 中打开

按顺序运行以下命令:

1claude plugin marketplace add ironwallet/ironwallet-agent-kit
2claude plugin install ironwallet-mcp@ironwallet

插件安装后,等待约 45 秒并开始新的聊天,以便加载工具。

或者直接将 Claude Code 指向 stdio 服务器:

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

独立页面,用于 Claude Code — 一次 HTTP 获取仅返回此指南。

VS Code

最高专家水平

需要 AI 模型付费版的额外插件

在 VS Code 中打开

打开 VS Code 并注册本地 MCP 服务器。您也可以将其添加到 VS Code MCP 设置(用户或工作区)中。

1{
2 "mcp": {
3 "servers": {
4 "ironwallet": {
5 "type": "stdio",
6 "command": "npx",
7 "args": ["-y", "@ironwallet/mcp-server"]
8 }
9 }
10 }
11}

独立页面,用于 VS Code — 一次 HTTP 获取仅返回此指南。

ChatGPT

设置简单 - 需要 ChatGPT

免费版非常有限,付费版效果更好

在 ChatGPT 中打开

按顺序运行以下命令,然后重新加载,以便 MCP 工具可用。

1codex plugin marketplace add ironwallet/ironwallet-agent-kit
2codex plugin add ironwallet-mcp@ironwallet

或者直接将 ChatGPT 指向 stdio 服务器:

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

独立页面,用于 ChatGPT — 一次 HTTP 获取仅返回此指南。

其他客户端

使用 stdio 传输。将您的 MCP 客户端指向:

1{
2 "mcpServers": {
3 "ironwallet": {
4 "command": "npx",
5 "args": ["-y", "@ironwallet/mcp-server"]
6 }
7 }
8}

独立页面,用于 其他客户端 — 一次 HTTP 获取仅返回此指南。

首次运行与钱包设置

无需登录,也无需账户。首次启动时,服务器会在 ~/.ironwallet-mcp/ 下生成其本地机密(中继 API 密钥、密钥库包装机密和设备 ID),并设置仅限所有者访问的权限。无需进行任何配置。

开始使用钱包:

1
同意. 在创建或导入钱包之前,智能体会先在聊天中显示 MCP 免责声明并记录您的接受情况 (accept_mcp_consent),或者您可以在钱包管理器中点击继续。
2
创建或导入. create_wallets 会返回钱包名称、地址以及一个 backup_url——在浏览器中打开它以查看并备份恢复助记词。要导入现有钱包或稍后进行备份,请使用 open_wallet_manager。恢复助记词仅在本地浏览器页面中输入或显示,绝不会出现在聊天中。
3
为钱包充值. 向智能体索要存款二维码 (get_deposit_qr) 或地址 (list_wallets) 并发送少量资金。请保持余额有限——这是一个热钱包。

磁盘数据

服务器将其状态保存在 ~/.ironwallet-mcp/ 中(可通过 IW_KEYSTORE_DIR 覆盖):

包含您钱包助记词的加密密钥库,

包装机密、中继 API 密钥和设备 ID,

位于 logs/ 下的诊断日志(助记词材料绝不会被记录)。

警告:请勿删除此目录以“重置”服务器。

它包含您资金的加密密钥。如果您在未备份钱包管理器中的恢复助记词的情况下将其删除,资金将会丢失。您的备份是恢复助记词,而不是这些文件。

任何拥有密钥库和包装机密的人都能控制这些资金,因此请将该目录视为敏感信息。

环境变量

大多数用户无需设置任何环境变量。服务器会在首次启动时生成并存储其所需的一切。以下环境变量可供高级用户使用:

变量
描述
默认值
IW_READ_ONLY
在进程范围内拒绝 send_transfer 和 execute_swap。与每个钱包的 policy.readOnly 不同
false
IW_KEYSTORE_DIR
密钥库目录
~/.ironwallet-mcp
IW_PASSPHRASE
覆盖密钥库包装机密
generated locally
IW_RELAY_API_KEY
覆盖中继 API 密钥
generated UUID
IW_HTTP_TIMEOUT_MS
常规 HTTP 超时
15000
IW_HTTP_FORWARD_TIMEOUT_MS
广播类调用的超时时间。客户端超时并不总是意味着操作失败——请检查状态
60000
IW_LOG_ENABLED
将 JSONL 诊断信息输出到日志文件(0 表示禁用)
1
IW_LOG_LEVEL
debug / info / warn / error
info

安全

助记词绝不会离开这台机器。 它们在静态存储时是加密的,绝不会出现在工具结果、智能体聊天、日志或后端请求中。没有任何工具会接收或返回助记词——导入和备份仅在本地浏览器中进行。

智能体无需再次询问即可移动资金。 没有每笔交易的确认界面;您的聊天消息即为授权。转账和兑换一旦广播即不可逆。

可选限额。 通过 set_wallet_policy 设置每个钱包的策略(readOnly、maxPerTxUsd、接收者白名单),以及服务器范围的 IW_READ_ONLY=true。两者默认均为关闭状态。

仅限热钱包。 请勿导入您的主钱包或储蓄钱包。任何拥有密钥库和包装机密的人都能控制这些资金;泄露的助记词无法撤销。

超时不等于失败。 在重试发送或兑换之前,请轮询 get_operation_status / get_swap_status。

所有后端请求均使用 HTTPS;本地机密文件使用仅限所有者的权限(Unix 0600,Windows 上的 NTFS ACL)。

漏洞披露:SECURITY.md。

测试

使用 MCP 检查器直接测试服务器。这将打开一个交互式 Web UI,您可以在其中测试工具调用,而无需 AI 助手。

npx @modelcontextprotocol/inspector npx -y @ironwallet/mcp-server

故障排除

MCP 客户端在首次启动时超时

npx 在首次运行时会下载该包,这可能需要约 30 秒。

  • 在终端中运行一次 npx -y @ironwallet/mcp-server 以预热缓存,然后重新连接。
  • 或者全局安装:npm install -g @ironwallet/mcp-server@latest。

工具未在客户端中显示

  • 检查是否安装了 Node.js 20+:node --version。
  • 安装后重新加载客户端,以便 PATH 包含 npx。
  • 插件安装后(Claude Code / ChatGPT),开始新的聊天以便加载工具。
  • 验证配置文件是否包含有效的 JSON 并重启客户端。
  • 使用 MCP 检查器手动测试服务器(见“测试”部分)。

create_wallets 返回 needs_consent

尚未接受 MCP 免责声明。要求智能体显示完整免责声明并确认 (accept_mcp_consent),或者打开钱包管理器并点击继续。

转账或兑换超时

超时不等于失败——交易可能已经广播。在重试之前,请轮询 get_operation_status(转账)或 get_swap_status(兑换)。切勿盲目重新提交。

发送或兑换被拒绝

  • 检查 list_wallets → policy:readOnly 或接收者白名单可能正在阻止该操作。{ enabled: false } 表示没有限制。
  • maxPerTxUsd 会进行故障安全检查:如果资产没有美元汇率,操作将被拒绝。
  • 检查服务器是否以 IW_READ_ONLY=true 运行。