无Gas区块链交互服务

0xGasless MCP Server是一款通过Claude AI实现无Gas区块链操作的服务,支持多链交易、代币交换和转账等功能。

  • by 0xgasless
  • TypeScript
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 0xgasless/mcp

使用说明

🚀 0x无气体MCP服务器

🔗 Claude AI的无缝区块链集成

直接从您的Claude对话中执行无气体交易、掉期和转账

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


🌟 什么是0xGasless MCP服务器?

这 0x无气体MCP服务器 是一个强大的 模型上下文协议 将Claude AI与区块链网络连接起来的服务器。建立在 ERC-4337账户摘要,它通过自然语言对话实现了无气体区块链操作。

✨ 主要亮点

  • 🆓 零天然气费 -在不持有本地令牌的情况下执行交易
  • 🌐 多链支持 -支持8+区块链网络
  • 🤖 人工智能原生 -自然语言区块链交互
  • 🔒 安全 -具有增强安全性的智能帐户抽象
  • ⚡ 即时设置 -一个命令克劳德集成

🛠️ 可用工具

工具 说明 示例用法
🏠 get-address 检索您的智能帐户地址 “我的钱包地址是什么?”
💰 get-balance 检查代币余额(支持ERC20) “显示我的USDC余额”
📤 transfer-token 无气体发送代币 “向alice.eth汇款10美元”
🔄 swap-tokens 无气体交换代币 “将100 USDT兑换为USDC”
🎯 buy-openrouter-credits 使用USDC购买AI积分 “购买25美元OpenRouter点数”
🌉 bridge-tokens 使用deBridge跨链桥接令牌 “从雪崩到以太坊的100美元桥梁”
📊 sxt-query-data 使用空间和时间查询区块链数据 “显示我的交易历史记录”

🚀 快速开始

📦 安装

首选安装方法:

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

⚙️ 配置

1.️⃣ 自动设置(最简单)

0xgasless-mcp configure

此交互式命令将:

  • ✅ 收集API密钥和配置
  • ✅ 检测您的操作系统
  • ✅ 自动配置克劳德桌面
  • ✅ 验证所有输入

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=43114                      # Target blockchain (see table below)
SXT_API_KEY=                        # Space & Time Api Key

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

🌐 支持的网络

🌍 网络 🆔 链ID 💎 本地令牌 🔗 RPC终结点
🔴 雪崩 43114 AVAX https://api.avax.network/ext/bc/C/rpc
🟡 BSC 56 BNB https://bsc-dataseed.binance.org/
🔵 基础 8453 ETH https://mainnet.base.org
⚫ 以太坊 1 ETH https://eth.llamarpc.com
🟣 多边形 137 MATIC https://polygon-rpc.com
🔵 音速 156 S https://sonic.drpc.org
🌙 月光 1284 GLMR https://rpc.api.moonbeam.network

🔗 Claude桌面集成

🎯 自动配置

与Claude Desktop集成的最简单方法:

0xgasless-mcp configure

📝 手动配置

添加到您的Claude Desktop配置文件中:

📍 配置位置:

  • 🍎 macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 🪟 视窗: %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"
      }
    }
  }
}

💬 使用示例

配置后,使用自然语言与区块链交互:

💰 余额查询

💬 "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"

📝 空间和时间信息

💬 "Find top 10 whale wallets who is doing millions of transactions yearly on Avalanche"

🎯 AI信用购买

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

🔑 API密钥设置

🎯 0xGasless API密钥

  1. 🌐 访问 0x无气仪表板
  2. 📝 创建帐户和新项目
  3. 🔑 复制API密钥
  4. 💳 向您的帐户添加积分

🤖 OpenRouter API密钥(可选)

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

🛠️ 发展

🏗️ 地方发展设置

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

# 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密钥保密
  • 🏦 智能账户:通过帐户抽象增强安全性
  • ⛽ 无气体操作:交易不需要本地令牌

⚠️ 重要说明

  • 🚫 切勿与任何人共享您的私钥
  • 💾 对敏感数据使用环境变量
  • 🔄 定期旋转API键
  • 📊 监控您的帐户使用情况和信用额度

🆘 故障排除

🐛 常见问题及解决方案

🔴 "Chain ID not supported"

解决方案:

  • ✅ 验证您使用的是上表中支持的链ID
  • ✅ 检查 支持的网络 章节
🔴 "API Key invalid"

解决方案:

  • ✅ 验证您的0xGasless API密钥是否正确
  • ✅ 确保您的0xGasless帐户有足够的信用额度
  • ✅ 检查API密钥权限和过期时间
🔴 "Insufficient balance"

解决方案:

  • ✅ 操作前检查代币余额
  • ✅ 确保您有足够的代币进行交易
  • ✅ 验证令牌合约地址是否正确
🔴 "Private key format error"

解决方案:

  • ✅ 确保私钥以“0x”开头
  • ✅ 验证它是否正好是66个字符(64+“0x”)
  • ✅ 检查是否有多余的空格或字符

🔍 调试模式

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

DEBUG=1 mcp

🤝 贡献

我们欢迎捐款!以下是如何开始:

🚀 快速贡献指南

  1. 🍴 分叉 存储库
  2. 🌿 创建 特征分支: git checkout -b feature/amazing-feature
  3. 💾 提交 您的更改: git commit -m 'Add amazing feature'
  4. 📤 推 分支机构: git push origin feature/amazing-feature
  5. 🔄 打开 拉取请求

📋 开发指南

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

📄 许可证

该项目根据 MIT许可证 -看看 许可证 文件以获取详细信息。


🙏 致谢

特别感谢让这一切成为可能的出色团队和项目:


📚 资源和链接

📖 文档

🔗 项目链接


🚀 由...制作❤️ 区块链社区

增强人工智能驱动的区块链交互

![在GitHub上关注] ![为该回购加星]