MCP Ledger Server

MCP分类账服务器

一个全面的模型上下文协议（MCP）服务器，用于将安全的Ledger硬件钱包与以太坊区块链操作集成。构建可以使用硬件级安全性与您的加密资产安全交互的AI代理。

🚀 特性

🔒 硬件钱包安全

• ✅ Ledger硬件钱包与最新的@ledgerhq库集成
• ✅ 私钥永远不会离开您的设备-所有签名都发生在硬件上
• ✅ 设备屏幕上需要交易确认
• ✅ BIP32衍生路径的多账户支持

⛓️ 多网络支持

• ✅ 6个网络：以太坊、Polygon、Arbitrum、乐观主义、Base、Sepolia
• ✅ 通过Alchemy API集成增强RPC
• ✅ 自动回退到公共端点
• ✅ EIP-1559交易支持，支持动态天然气定价

🪙 完整的资产管理

• ✅ 所有网络上的实时ETH余额
• ✅ 通过Dune Sim API发现和平衡ERC20代币
• ✅ ERC721/ERC1155 NFT跟踪和传输
• ✅ 令牌审批管理（批准/撤销/修改）
• ✅ 美元定价和投资组合估值

🤖 AI代理就绪

• ✅ 14个MCP工具 用于完整的区块链操作
• ✅ 一个命令便利功能（发送ETH、转移代币等）
• ✅ 自动气体估算的交易制作
• ✅ 使用以太坊（SIWE）登录的消息签名
• ✅ 实时气体分析和优化

📋 可用工具

🔍 钱包和余额工具

⚡ 交易工具

🎯 便利工具（一键操作）

🛠️ 开发者工具

🚀 快速开始

1. 再进行

# Clone and install
git clone 
cd mcp-ledger
npm install
npm run build

2. 获取API密钥

🔑 必需：Dune Sim API

# Get your free API key at: https://sim.dune.com
# Required for token/NFT discovery across 60+ chains
DUNE_SIM_API_KEY=your_dune_sim_api_key_here

📊 可选：性能API

# Alchemy (recommended) - Enhanced RPC performance
# Get key at: https://alchemy.com (2M+ requests/month free)
ALCHEMY_API_KEY=your_alchemy_api_key_here

# Etherscan (optional) - Contract verification  
# Get key at: https://etherscan.io/apis (100k requests/day free)
ETHERSCAN_API_KEY=your_etherscan_api_key_here

3. 配置环境

# Copy template and add your keys
cp .env.example .env
# Edit .env with your API keys

4. 连接您的分类账

1. 🔌 连接 通过USB连接的分类账设备
2. 🔓 解锁 带PIN的设备
3. 📱 打开 以太坊应用程序
4. ⚙️ 启用 以太坊应用程序设置中的“盲签名”

5. 测试连接

# Test basic connection
node test-ledger-connection.js

# Test MCP server
npm start
# In another terminal:
node test-server.cjs

🖥️ 添加到您的AI工具

克劳德桌面 （macOS/Windows）

1. 打开克劳德桌面设置
2. 增添 claude_desktop_config.json:

{
  "mcpServers": {
    "mcp-ledger": {
      "command": "node",
      "args": ["/path/to/mcp-ledger/dist/index.js"],
      "env": {
        "DUNE_SIM_API_KEY": "your_key_here",
        "ALCHEMY_API_KEY": "your_key_here"
      }
    }
  }
}

光标IDE

1. 打开光标设置→ 扩展→ MCP
2. 添加服务器配置：

{
  "name": "mcp-ledger", 
  "command": "node",
  "args": ["/path/to/mcp-ledger/dist/index.js"],
  "env": {
    "DUNE_SIM_API_KEY": "your_key_here"
  }
}

带有MCP扩展的VS代码

1. 安装MCP扩展
2. 添加到MCP设置：

{
  "mcp.servers": {
    "ledger": {
      "command": "node",
      "args": ["/absolute/path/to/mcp-ledger/dist/index.js"],
      "env": {
        "DUNE_SIM_API_KEY": "your_key_here"
      }
    }
  }
}

其他MCP兼容工具

使用此通用配置模式：

• 命令: node
• 参数: ["/path/to/mcp-ledger/dist/index.js"]
• 运输：stdio
• 环境：添加API密钥

💡 使用示例

检查您的投资组合

Show me my ETH balance and top 5 token holdings on mainnet

发送付款

Send 0.1 ETH to 0x742d35Cc6631C0532925a3b8D0c7e89e5a3A5d34 on mainnet

转移代币

Send 100 USDC to my friend at 0x... on polygon network

管理审批

Revoke all token approvals for Uniswap router on mainnet

气体优化

Analyze current gas prices on mainnet and recommend optimal settings for an ERC20 transfer

NFT操作

Transfer my CryptoPunk #1234 to 0x... and show me the transaction details

🔧 高级配置

自定义网络

在中添加自定义RPC终结点 .env:

# Custom RPC URLs (optional)
MAINNET_RPC_URL=https://your-custom-rpc.com
POLYGON_RPC_URL=https://polygon-custom.com

发展模式

# Run in development with hot reload
npm run dev

# Run comprehensive tests
npm run test:all

# Test with real hardware (Ledger required)
npm run test:hardware

性能调整

# Adjust cache and timeout settings
REQUEST_TIMEOUT=60000  # 60 second timeout
CACHE_TTL=600         # 10 minute cache

🚫 没有必需的API

⚠️ 重要：没有 DUNE_SIM_API_KEY:

• ❌ 令牌发现不起作用
• ❌ NFT发现不起作用
• ❌ 只有基本的ETH操作可用
• ✅ 账簿签名仍然有效
• ✅ 定制交易制作工作

🏗️ 建筑

核心技术

• TypeScript -全型安全，配置严格
• 我知道 -用于区块链交互的现代以太坊库
• Ledger SDK -官方硬件钱包集成
• MCP-SDK -模型上下文协议合规性
• 萨德 -运行时模式验证

服务体系结构

• 🔄 服务编排器 -协调所有操作
• 🔐 LedgerService -硬件钱包通信
• ⛓️ 区块链服务 -多网络RPC管理
• 🏗️ 交易工匠 -智能交易大楼
• 🔍 BlockscoutClient -合同验证和ABI

安全模型

🔒 硬件安全:

• ✅ 私钥永远不会离开Ledger设备
• ✅ 所有交易都需要实物确认
• ✅ BIP32分层确定性密钥推导
• ✅ 全面的输入验证

🛡️ 软件安全:

• ✅ 对所有输入进行Zod模式验证
• ✅ 多层错误处理
• ✅ 通过stdio传输进行进程隔离
• ✅ 本地使用无需身份验证

📊 网络状态验证

启动服务器时，您将看到配置状态：

✅ 最佳设置:

✅ Dune Sim API configured for reliable token discovery
✅ Enhanced RPC provider configured (Alchemy) 
✅ Contract verification API configured (Etherscan)
✅ Ledger device connected successfully

⚠️ 有限设置:

❌ DUNE_SIM_API_KEY is required for token discovery functionality
⚠️  No enhanced RPC provider configured. Using public endpoints.
⚠️  Ledger device not connected (can be connected later)

🤝 贡献

基于现代TypeScript实践构建：

• 🧪 综合测试套件（单元、集成、e2e、硬件）
• 📏 ESLint + TypeScript 严格模式
• 🔄 自动化CI/CD流水线
• 📖 API完整文档

📄 许可证

MIT许可证-请参阅 许可证 文件以获取详细信息。

______________________________________________________________________

🔒 确保您的加密货币安全：此工具通过将您的私钥保存在硬件上来增强安全性，同时使您的加密资产能够进行强大的人工智能交互。

内置于❤️ 靠近 Dennison Bertram