STARWARCLOUD STARWAR.AI
返回市场
麦普

麦普

作者：0xgasless3 星标更新：2025-08-28
安装使用来源：spider==github.com

项目介绍

🚀 0xGasless MCP 服务器

🔗 与 Claude AI 的无缝区块链集成

从您的 Claude 对话中直接执行无 Gas 费用的交易、交换和转账

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

🌟 什么是 0xGasless MCP 服务器？

0xGasless MCP 服务器 是一个强大的 模型上下文协议 服务器，它将 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 信用"
🌉 bridge-tokens使用 deBridge 在链之间转移代币"将 100 USDC 从 Avalanche 转移到 Ethereum"
📊 sxt-query-data使用 Space 和 Time 查询区块链数据"显示我的交易历史"

🚀 快速开始

📦 安装

推荐安装方法：

# 全局安装（推荐）
npm install -g 0xgasless/mcp

⚙️ 配置

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

0xgasless-mcp configure

此交互式命令将：

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

2️⃣ 手动环境设置

创建一个 .env 文件并添加您的配置：

# 🔑 必需配置
PRIVATE_KEY=0x...                   # 您的钱包私钥
RPC_URL=https://...                 # 区块链 RPC 终点
API_KEY=your_0xgasless_api_key      # 来自 dashboard.0xgasless.com
CHAIN_ID=43114                      # 目标区块链（见下表）
SXT_API_KEY=                        # Space & Time API 密钥

# 🎯 可选配置  
OPENROUTER_API_KEY=your_key         # 用于 AI 信用购买

🌐 支持的网络

🌍 网络🆔 链 ID💎 原生代币🔗 RPC 终点
🔴 Avalanche43114AVAXhttps://api.avax.network/ext/bc/C/rpc
🟡 BSC56BNBhttps://bsc-dataseed.binance.org/
🔵 Base8453ETHhttps://mainnet.base.org
⚫ Ethereum1ETHhttps://eth.llamarpc.com
🟣 Polygon137MATIChttps://polygon-rpc.com
🔵 Sonic156Shttps://sonic.drpc.org
🌙 Moonbeam1284GLMRhttps://rpc.api.moonbeam.network

🔗 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": "43114",
        "SXT_API_KEY": "your_space_&_time_api_key",
        "OPENROUTER_API_KEY": "your_openrouter_key"
      }
    }
  }
}

💬 使用示例

一旦配置完成，您可以使用自然语言与区块链进行交互：

💰 余额查询

💬 "我的钱包余额是多少？"
💬 "检查我在 BSC 上的 USDC 余额"
💬 "显示我所有的代币余额"

📤 代币转账

💬 "向 0x742d35Cc6634C0532925a3b8D4C9db96590b5c8e 发送 10 USDT"
💬 "将 0.1 BNB 转移给 alice.eth"
💬 "向我朋友的钱包发送 50 USDC"

🔄 代币交换

💬 "将 100 USDT 兑换为 USDC"
💬 "将 0.5 BNB 转换为 WETH"
💬 "将 1000 BUSD 转换为 BNB"

📝 Space & Time 信息

💬 "查找在 Avalanche 上每年进行数百万次交易的前 10 大鲸鱼钱包"

🎯 AI 信用购买

💬 "购买价值 10 美元的 OpenRouter 信用"
💬 "使用 USDC 购买价值 25 美元的 OpenRouter 信用"

🔑 API 密钥设置

🎯 0xGasless API 密钥

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

🤖 OpenRouter API 密钥（可选）

  1. 🌐 访问 OpenRouter.ai
  2. 📝 注册并导航到 API 密钥
  3. 🔑 生成新的 API 密钥
  4. 💰 为 AI 模型访问充值

🛠️ 开发

🏗️ 本地开发设置

# 克隆仓库
git clone https://github.com/0xgasless/mcp
cd mcp

# 安装依赖
npm install

# 构建项目
npm run build

# 开发模式，热重载
npm run dev

# 启动服务器
npm start

📁 项目结构

src/
├── 🎯 main.ts          # 核心 MCP 服务器实现
├── 🚀 index.ts         # CLI 入口点及配置
├── 📋 version.ts       # 版本管理
└── 📝 types/           # TypeScript 定义

🔐 安全与最佳实践

🛡️ 安全指南

  • 🔒 私钥：安全存储在环境变量中，绝不在代码中存储
  • 🔑 API 密钥：保持 0xGasless 和 OpenRouter 密钥机密
  • 🏦 智能账户：通过账户抽象增强安全性
  • ⛽ 无 Gas 操作：无需原生代币即可执行交易

⚠️ 重要提示

  • 🚫 不要与任何人分享您的私钥
  • 💾 使用环境变量存储敏感数据
  • 🔄 定期轮换您的 API 密钥
  • 📊 监控您的账户使用情况和信用额度

🆘 故障排除

🐛 常见问题及解决方案

<details> <summary>🔴 "不支持的链 ID"</summary>

解决方案：

  • ✅ 确认您使用的链 ID 是否在上述表格中列出
  • ✅ 查看 支持的网络 部分
</details> <details> <summary>🔴 "API 密钥无效"</summary>

解决方案：

  • ✅ 确认您的 0xGasless API 密钥是否正确
  • ✅ 确保您的 0xGasless 账户有足够的信用额度
  • ✅ 检查 API 密钥权限和有效期
</details> <details> <summary>🔴 "余额不足"</summary>

解决方案：

  • ✅ 在操作前检查代币余额
  • ✅ 确保有足够的代币进行交易
  • ✅ 确认代币合约地址正确
</details> <details> <summary>🔴 "私钥格式错误"</summary>

解决方案：

  • ✅ 确认私钥以 "0x" 开头
  • ✅ 确认其长度为 66 字符（64 + "0x"）
  • ✅ 检查是否有额外的空格或字符
</details>

🔍 调试模式

启用详细日志以进行故障排除：

DEBUG=1 mcp

🤝 贡献

我们欢迎贡献！以下是开始的方法：

🚀 快速贡献指南

  1. 🍴 分叉 仓库
  2. 🌿 创建 功能分支：git checkout -b feature/amazing-feature
  3. 💾 提交 您的更改：git commit -m '添加神奇功能'
  4. 📤 推送 到分支：git push origin feature/amazing-feature
  5. 🔄 打开 拉取请求

📋 开发指南

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

📄 许可

本项目采用 MIT 许可 - 详情请参阅 LICENSE 文件。

🙏 致谢

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

📚 资源与链接

📖 文档

🔗 项目链接

<div align="center">

🚀 为区块链社区打造，充满爱心

赋能 AI 驱动的区块链交互

![关注 GitHub] ![点赞此仓库]

</div>