🚀 0xGasless MCP Server

🚀 0xGasless MCP Server

🔗 为 Claude AI 提供无缝区块链集成

直接在 Claude 对话中执行免 Gas 交易、兑换和转账

🚀 快速开始 • 📖 文档 • 🛠️ 开发 • 🤝 参与贡献

---

🌟 什么是 0xGasless MCP Server？

0xGasless MCP Server 是一个强大的 Model Context Protocol 服务，可连接 Claude AI 与区块链网络。它基于 ERC-4337 账户抽象构建，让你能够通过自然语言对话执行免 Gas 区块链操作。

✨ 主要亮点

• 🆓 零 Gas 费用 - 无需持有原生代币即可执行交易
• 🌐 多链支持 - 支持 8 个以上区块链网络
• 🤖 原生支持 AI - 通过自然语言与区块链交互
• 🔒 安全可靠 - 智能账户抽象，安全性更高
• ⚡ 即时设置 - 一条命令即可集成 Claude

---

🛠️ 可用工具

工具	描述	使用示例
🏠 get-address	获取你的智能账户地址	“我的钱包地址是什么？”
💰 get-balance	查询代币余额（支持 ERC20）	“显示我的 USDC 余额”
📤 transfer-token	免 Gas 发送代币	“向 alice.eth 发送 10 USDT”
🔄 swap-tokens	免 Gas 兑换代币	“将 100 USDT 兑换成 USDC”
🎯 buy-openrouter-credits	使用 USDC 购买 AI 额度	“购买 25 美元的 OpenRouter 额度”

---

🚀 快速开始

📦 安装

选择你偏好的安装方式：

# Global installation (recommended)
npm install -g 0xgasless-mcp

# Or use directly with npx
npx 0xgasless-mcp

⚙️ 配置

1️⃣ 自动设置（最简单）

0xgasless-mcp configure

此交互式命令将：

• ✅ 收集你的 API 密钥和配置信息
• ✅ 检测你的操作系统
• ✅ 自动配置 Claude Desktop
• ✅ 验证所有输入

2️⃣ 手动设置环境

创建 .env 文件并填写配置：

# 🔑 Required Configuration
PRIVATE_KEY=0x...                    # Your wallet private key
RPC_URL=https://...                  # Blockchain RPC endpoint
API_KEY=your_0xgasless_api_key      # From dashboard.0xgasless.com
CHAIN_ID=56                         # Target blockchain (see table below)

# 🎯 Optional Configuration  
OPENROUTER_API_KEY=your_key         # For AI credit purchases

---

🌐 支持的网络

🌍 网络	🆔 Chain ID	💎 原生代币	🔗 RPC 端点
🟡 BSC	56	BNB	https://bsc-dataseed.binance.org/
🔵 Base	8453	ETH	https://mainnet.base.org
⚫ Ethereum	1	ETH	https://eth.llamarpc.com
🟣 Polygon	137	MATIC	https://polygon-rpc.com
🔴 Avalanche	43114	AVAX	https://api.avax.network/ext/bc/C/rpc
🔵 Fantom	250	FTM	https://rpc.ftm.tools
🌙 Moonbeam	1284	GLMR	https://rpc.api.moonbeam.network
🟢 Metis	1088	METIS	https://andromeda.metis.io/?owner=1088

---

🔗 集成 Claude Desktop

🎯 自动配置

与 Claude Desktop 集成的最简单方式：

0xgasless-mcp configure

📝 手动配置

将以下内容添加到 Claude Desktop 配置文件：

📍 配置文件位置：

• 🍎 macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• 🪟 Windows：%APPDATA%\Claude\claude_desktop_config.json
• 🐧 Linux：~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "0xgasless": {
      "command": "npx",
      "args": ["0xgasless-mcp-server"],
      "env": {
        "PRIVATE_KEY": "0x...",
        "RPC_URL": "https://...",
        "API_KEY": "your_0xgasless_api_key",
        "CHAIN_ID": "56",
        "OPENROUTER_API_KEY": "your_openrouter_key"
      }
    }
  }
}

---

💬 使用示例

配置完成后，使用自然语言与区块链交互：

💰 余额查询

💬 "What's my wallet balance?"
💬 "Check my USDC balance on BSC"
💬 "Show all my token balances"

📤 代币转账

💬 "Send 10 USDT to 0x742d35Cc6634C0532925a3b8D4C9db96590b5c8e"
💬 "Transfer 0.1 BNB to alice.eth"
💬 "Send 50 USDC to my friend's wallet"

🔄 代币兑换

💬 "Swap 100 USDT for USDC"
💬 "Exchange 0.5 BNB to WETH"
💬 "Convert 1000 BUSD to BNB"

🎯 购买 AI 额度

💬 "Buy $10 worth of OpenRouter credits"
💬 "Purchase $25 OpenRouter credits with USDC"

---

🔑 设置 API 密钥

🎯 0xGasless API 密钥

1. 🌐 访问 0xGasless 控制面板
2. 📝 创建账户和新项目
3. 🔑 复制你的 API 密钥
4. 💳 为账户充值

🤖 OpenRouter API 密钥（可选）

1. 🌐 访问 OpenRouter.ai
2. 📝 注册并前往 API 密钥页面
3. 🔑 生成新的 API 密钥
4. 💰 充值以使用 AI 模型

---

🛠️ 开发

🏗️ 本地开发环境设置

# Clone the repository
git clone https://github.com/achiit/0xgasless-mcp-server.git
cd 0xgasless-mcp-server

# Install dependencies
npm install

# Build the project
npm run build

# Development mode with hot reload
npm run dev

# Start the server
npm start

📁 项目结构

src/
├── 🎯 main.ts          # Core MCP server implementation
├── 🚀 index.ts         # CLI entry point & configuration
├── 📋 version.ts       # Version management
└── 📝 types/           # TypeScript definitions

---

🔐 安全与最佳实践

🛡️ 安全指南

• 🔒 私钥：安全存储在环境变量中，切勿写入代码
• 🔑 API 密钥：对 0xGasless 和 OpenRouter 密钥保密
• 🏦 智能账户：通过账户抽象增强安全性
• ⛽ 免 Gas 操作：交易无需原生代币

⚠️ 重要提示

• 🚫 切勿向任何人透露您的私钥
• 💾 使用环境变量存储敏感数据
• 🔄 定期轮换 API 密钥
• 📊 监控账户用量和额度

---

🆘 故障排除

🐛 常见问题与解决方案

🔴 “不支持此 Chain ID”

解决方案：

• ✅ 确认使用的是上表中的受支持 Chain ID
• ✅ 查看受支持的网络部分

🔴 “API 密钥无效”

解决方案：

• ✅ 确认您的 0xGasless API 密钥正确无误
• ✅ 确保您的 0xGasless 账户有足够的额度
• ✅ 检查 API 密钥的权限和有效期

🔴 “余额不足”

解决方案：

• ✅ 操作前检查代币余额
• ✅ 确保您有足够的代币完成交易
• ✅ 确认代币合约地址正确无误

🔴 “私钥格式错误”

解决方案：

• ✅ 确保私钥以“0x”开头
• ✅ 确认长度恰好为 66 个字符（64 + “0x”）
• ✅ 检查是否包含多余的空格或字符

🔍 调试模式

启用详细日志以排查问题：

DEBUG=1 0xgasless-mcp-server

---

🤝 参与贡献

欢迎贡献！以下是开始参与的方法：

🚀 快速贡献指南

1. 🍴 Fork 此仓库
2. 🌿 创建 功能分支：git checkout -b feature/amazing-feature
3. 💾 提交 更改：git commit -m 'Add amazing feature'
4. 📤 推送 到分支：git push origin feature/amazing-feature
5. 🔄 发起 Pull Request

📋 开发指南

• ✅ 遵循 TypeScript 最佳实践
• ✅ 为新功能添加测试
• ✅ 根据需要更新文档
• ✅ 提交前确保所有测试通过

---

📄 许可证

本项目采用 MIT 许可证授权，详情请参阅 LICENSE 文件。

---

🙏 致谢

特别感谢让这一切成为可能的优秀团队和项目：

• 🎯 0xGasless - 智能账户基础设施
• 🤖 Model Context Protocol - MCP 规范
• 🧠 Claude - AI 集成能力
• 🌐 OpenRouter - AI API 访问平台

---

📚 资源与链接

📖 文档

• 📘 0xGasless 文档
• 📗 MCP 文档
• 📙 Claude MCP 指南

🔗 项目链接

• 🏠 GitHub 仓库
• 📦 npm 包
• 🐛 报告问题
• 💬 讨论区

---