🚀 0xGasless MCP Server

🚀 0xGasless MCP Server

🔗 Claude AI のためのシームレスなブロックチェーン連携

Claude との会話から直接、ガス代不要のトランザクション、スワップ、送金を実行できます

🚀 クイックスタート • 📖 ドキュメント • 🛠️ 開発 • 🤝 貢献

---

🌟 0xGasless MCP Server とは？

0xGasless MCP Server は、Claude AI とブロックチェーンネットワークをつなぐ、強力な Model Context Protocol サーバーです。ERC-4337 アカウント抽象化を基盤とし、自然言語での会話を通じて、ガス代不要のブロックチェーン操作を実現します。

✨ 主な特長

• 🆓 ガス代ゼロ - ネイティブトークンを保有せずにトランザクションを実行
• 🌐 マルチチェーン対応 - 8 つ以上のブロックチェーンネットワークに対応
• 🤖 AI ネイティブ - 自然言語でブロックチェーンを操作
• 🔒 安全 - セキュリティを強化したスマートアカウント抽象化
• ⚡ 即時セットアップ - ワンコマンドで Claude と連携

---

🛠️ 利用可能なツール

ツール	説明	使用例
🏠 get-address	スマートアカウントのアドレスを取得します	「自分のウォレットアドレスは？」
💰 get-balance	トークン残高を確認します（ERC20 対応）	「USDC の残高を表示して」
📤 transfer-token	ガス代不要でトークンを送金します	「10 USDT を alice.eth に送って」
🔄 swap-tokens	ガス代不要でトークンを交換します	「100 USDT を USDC にスワップして」
🎯 buy-openrouter-credits	USDC で AI クレジットを購入します	「OpenRouter クレジットを 25 ドル分購入して」

---

🚀 クイックスタート

📦 インストール

お好みのインストール方法を選択してください：

# 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

---

🌐 対応ネットワーク

🌍 ネットワーク	🆔 チェーン 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 Dashboard にアクセスします
2. 📝 アカウントと新しいプロジェクトを作成します
3. 🔑 API キーをコピーします
4. 💳 アカウントにクレジットを追加します

🤖 OpenRouter API キー（任意）

1. 🌐 OpenRouter.ai にアクセスします
2. 📝 登録して API Keys に移動します
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 のキーは秘密にしてください
• 🏦 スマートアカウント：アカウント抽象化によってセキュリティが強化されます
• ⛽ ガスレス操作：トランザクションにネイティブトークンは不要です

⚠️ 重要な注意事項

• 🚫 秘密鍵を誰にも共有しないでください
• 💾 機密データには環境変数を使用してください
• 🔄 API キーは定期的にローテーションしてください
• 📊 アカウントの使用状況とクレジットを監視してください

---

🆘 トラブルシューティング

🐛 よくある問題と解決策

🔴 「Chain ID not supported」

解決策：

• ✅ 上記の表にあるサポート対象の Chain ID を使用していることを確認してください
• ✅ サポート対象ネットワークのセクションを確認してください

🔴 「API Key invalid」

解決策：

• ✅ 0xGasless の API キーが正しいことを確認してください
• ✅ 0xGasless アカウントに十分なクレジットがあることを確認してください
• ✅ API キーの権限と有効期限を確認してください

🔴 「Insufficient balance」

解決策：

• ✅ 操作の前にトークン残高を確認してください
• ✅ トランザクションに十分なトークンがあることを確認してください
• ✅ トークンコントラクトアドレスが正しいことを確認してください

🔴 「Private key format error」

解決策：

• ✅ 秘密鍵が「0x」で始まっていることを確認してください
• ✅ 文字数が正確に66文字（64文字＋「0x」）であることを確認してください
• ✅ 余分なスペースや文字がないか確認してください

🔍 デバッグモード

トラブルシューティング用に詳細なログ記録を有効にします：

DEBUG=1 0xgasless-mcp-server

---

🤝 コントリビューション

コントリビューションを歓迎します！始めるには、次の手順に従ってください。

🚀 コントリビューションの簡単な手引き

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 Licenseの下でライセンスされています。詳細はLICENSEファイルをご覧ください。

---

🙏 謝辞

この実現を支えてくださった素晴らしいチームやプロジェクトに、心より感謝します。

• 🎯 0xGasless - スマートアカウントのインフラストラクチャ
• 🤖 Model Context Protocol - MCP 仕様
• 🧠 Claude - AI 統合機能
• 🌐 OpenRouter - AI API アクセスプラットフォーム

---

📚 リソースとリンク

📖 ドキュメント

• 📘 0xGasless ドキュメント
• 📗 MCP ドキュメント
• 📙 Claude MCP ガイド

🔗 プロジェクトリンク

• 🏠 GitHub リポジトリ
• 📦 npm パッケージ
• 🐛 問題を報告
• 💬 ディスカッション

---