AI导哈

以太坊钱包管理服务

Lobster Wallet是一款通过MCP协议为AI代理提供安全、审计的以太坊钱包管理服务，支持HD钱包、种子加密和多链交易。

  • by davis-williams-ai
  • JavaScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 davis-williams-ai/lobster-wallet

使用说明

🦞 龙虾钱包

通过MCP为AI代理提供以太坊钱包管理

⚠️ 测试版软件 --该项目正在积极开发中，应被视为实验性项目。使用风险自负。真实网络上的交易可能会导致 永久性、不可逆转的资金损失。不要使用你无法承受损失的资产。不提供保修。看 许可证.

龙虾钱包是 模型上下文协议（MCP） 服务器，为AI代理提供安全、经过审计的以太坊钱包访问权限。仅限HD的钱包，具有静止的种子加密、飞行前交易验证和1ETH的安全上限——旨在使代理可以在不暴露密钥的情况下进行交易。

特性

  • 🔐 种子加密处于静止状态 --AES-256-GCM，密钥永不离开主机
  • 🧩 HD钱包，账户分离 --BIP-44衍生，每个钱包多个账户
  • ⛓️ 9个内置EVM链 +添加任何自定义链
  • 🪙 ERC-20、ERC-721、ERC-1155 令牌支持
  • 🛡️ 默认安全 --1个ETH上限、飞行前验证、审计记录
  • 🔇 输出中没有按键 --助记词和私钥永远不会返回给代理
  • 📋 21工具 涵盖钱包生命周期、签名、交易和基础设施

快速开始

# Install
npm install -g lobster-wallet

# Set encryption key (required)
export LOBSTER_ENCRYPTION_KEY="your-secret-key"

# Optional: BIP-39 passphrase for additional seed protection
export LOBSTER_PASSPHRASE="your-optional-passphrase"

克劳德桌面

增添 claude_desktop_config.json:

{
  "mcpServers": {
    "lobster-wallet": {
      "command": "lobster-wallet",
      "env": {
        "LOBSTER_ENCRYPTION_KEY": "your-secret-key"
      }
    }
  }
}

光标

增添 .cursor/mcp.json:

{
  "mcpServers": {
    "lobster-wallet": {
      "command": "lobster-wallet",
      "env": {
        "LOBSTER_ENCRYPTION_KEY": "your-secret-key"
      }
    }
  }
}

OpenClaw/mcporter

mcporter config add lobster-wallet --stdio "lobster-wallet"
mcporter call lobster-wallet.list_wallets

工具

钱包生命周期

工具 说明
create_wallet 创建新的HD钱包（BIP-39助记符）
create_account 从HD钱包获取额外账户
delete_wallet 永久删除钱包
label_account 在帐户上设置可读标签
archive_account 存档帐户（隐藏在默认列表中）

查询

工具 说明
list_wallets 列出所有钱包和账户（永远不要暴露密钥）
get_address 获取钱包/账户的以太坊地址
check_balance 检查ETH余额——自己的钱包或任何地址
get_tokens 检查ERC-20/721/1155代币余额
estimate_gas 估算交易的天然气成本

签署

工具 说明
sign_message 通过EIP-191签署消息（personal_Sign）
sign_typed_data 通过EIP-712对结构化数据进行签名

交易

工具 说明
send_tx 发送带有飞行前验证的ETH（1 ETH上限）
send_token 发送ERC-20代币（必须先列入白名单）
submit_tx 向网络提交原始签名交易
check_tx 检查交易状态和收据

基础设施

工具 说明
manage_chains 添加、删除或列出区块链网络
manage_tokens 管理令牌白名单（ERC-20/721/1155）
encode_calldata ABI编码函数调用数据
read_contract 从任何智能合约读取（查看/纯调用）
list_pending_txs 列出待处理/未确认的交易

支撑链

链 类型 链ID
以太坊 主网 1
基础 主网 8453
仲裁 主网 42161
乐观 主网 10
多边形 主网 137
威立雅 测试网 11155111
基础Sepolia 测试网 84532
夏枯草 测试网 421614
乐观主义Sepolia 测试网 11155420

通过以下方式添加任何EVM兼容链 manage_chains.

代币支持

  • ERC-20 --可替代代币（USDC、WETH等）
  • ERC-721 — NFT
  • ERC-1155 --多令牌标准

令牌必须通过以下方式添加到白名单中 manage_tokens 在查询余额或发送之前。

安全

图层 详图
加密 使用AES-256-GCM对静止种子进行加密
口令短语 可选BIP-39密码 LOBSTER_PASSPHRASE
验证 每次解密时验证帐户0地址
安全帽 每笔交易最多1 ETH（BigInt精度）
飞行前 发送前检查平衡+气体
审计日志 所有操作记录到 ~/.lobster-wallet/audit.log
无关键风险 助记词和私钥永远不会出现在工具输出或错误中
签署 只有EIP-191和EIP-712——没有原始 eth_sign

配置

环境变量 必填 说明
LOBSTER_ENCRYPTION_KEY ✅ 种子存储加密密钥（AES-256-GCM）
LOBSTER_PASSPHRASE ❌ 可选的BIP-39密码用于额外的种子保护

数据存储在 ~/.lobster-wallet/:

  • wallets.json --加密钱包数据
  • tokens.json --令牌白名单
  • chains.json --链条配置
  • audit.log --运营审计跟踪

发展

git clone https://github.com/davis-williams-ai/lobster-wallet.git
cd lobster-wallet
npm install

# Run unit tests
npm test

# Run end-to-end tests (spins up a local Hardhat network)
npm run test:e2e

建筑

  • 自动发现的工具 --下降a .js 归档 src/tools/ 它是自动注册的
  • 基于文件的存储 --JSON文件 ~/.lobster-wallet/，不需要数据库
  • 每次通话无状态 --每个MCP工具调用都是独立的
  • 内置ABI --包括ERC-20/721/1155；将自定义ABI添加到 ~/.lobster-wallet/abis/

贡献

欢迎投稿！请打开问题或提交拉取请求。

  1. 分叉回购
  2. 创建功能分支(git checkout -b feat/my-feature)
  3. 提交您的更改
  4. 推送并打开PR

许可证

麻省理工学院 ©2026戴维斯威廉姆斯艾

相关 MCP