使用说明
🚀 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密钥
- 🌐 访问 0x无气仪表板
- 📝 创建帐户和新项目
- 🔑 复制API密钥
- 💳 向您的帐户添加积分
🤖 OpenRouter API密钥(可选)
- 🌐 访问 OpenRouter.ai
- 📝 注册并导航到API密钥
- 🔑 生成新的API密钥
- 💰 为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键
- 📊 监控您的帐户使用情况和信用额度
🆘 故障排除
🐛 常见问题及解决方案
🔴 "API Key invalid"
解决方案:
- ✅ 验证您的0xGasless API密钥是否正确
- ✅ 确保您的0xGasless帐户有足够的信用额度
- ✅ 检查API密钥权限和过期时间
🔴 "Insufficient balance"
解决方案:
- ✅ 操作前检查代币余额
- ✅ 确保您有足够的代币进行交易
- ✅ 验证令牌合约地址是否正确
🔴 "Private key format error"
解决方案:
- ✅ 确保私钥以“0x”开头
- ✅ 验证它是否正好是66个字符(64+“0x”)
- ✅ 检查是否有多余的空格或字符
🔍 调试模式
启用详细日志以进行故障排除:
DEBUG=1 mcp
🤝 贡献
我们欢迎捐款!以下是如何开始:
🚀 快速贡献指南
- 🍴 分叉 存储库
- 🌿 创建 特征分支:
git checkout -b feature/amazing-feature - 💾 提交 您的更改:
git commit -m 'Add amazing feature' - 📤 推 分支机构:
git push origin feature/amazing-feature - 🔄 打开 拉取请求
📋 开发指南
- ✅ 遵循TypeScript的最佳实践
- ✅ 为新功能添加测试
- ✅ 根据需要更新文档
- ✅ 提交前确保所有测试通过
📄 许可证
该项目根据 MIT许可证 -看看 许可证 文件以获取详细信息。
🙏 致谢
特别感谢让这一切成为可能的出色团队和项目:
📚 资源和链接
📖 文档
🔗 项目链接
🚀 由...制作❤️ 区块链社区
增强人工智能驱动的区块链交互