🦞 龙虾钱包
通过MCP为AI代理提供以太坊钱包管理
 ](https://nodejs.org)
______________________________________________________________________
⚠️ 测试版软件 --该项目正在积极开发中,应被视为实验性项目。使用风险自负。真实网络上的交易可能会导致 永久性、不可逆转的资金损失。不要使用你无法承受损失的资产。不提供保修。看 许可证.
______________________________________________________________________
龙虾钱包是 模型上下文协议(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/
贡献
欢迎投稿!请打开问题或提交拉取请求。
- 分叉回购
- 创建功能分支(
git checkout -b feat/my-feature) - 提交您的更改
- 推送并打开PR
许可证
麻省理工学院 ©2026戴维斯威廉姆斯艾
