Ucai

🚀 ユニバーサルコントラクトAIインターフェース

ABIからMCPサーバーを生成するツールで、あらゆるコントラクトをAIが扱えるようにします。

🚀 クイックスタート

このツールは、ABI（Application Binary Interface）からMCP（Model Context Protocol）サーバーを生成し、ClaudeなどのAIがスマートコントラクトと対話できるようにします。以下は、簡単な使い方です。

1. サーバーの生成

abi-to-mcp generate 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D -o ~/uniswap-server
cd ~/uniswap-server && pip install -r requirements.txt

2. Claude Desktopへの接続

Macの場合は、以下の設定ファイルに追加します。

{
  "mcpServers": {
    "uniswap": {
      "command": "python",
      "args": ["/Users/YOU/uniswap-server/server.py"],
      "env": {
        "RPC_URL": "https://eth.llamarpc.com"
      }
    }
  }
}

3. Claudeへの問い合わせ

以下のような質問をすることができます。

• "What's the best route to swap 1 ETH for USDC?"
• "Get the reserves for the ETH/DAI pool"
• "Show me recent swaps on Uniswap"

これで、ClaudeがDeFiを理解し、操作できるようになります。

✨ 主な機能

• 🛡️ セキュリティスキャナー — 接続前に、rug pull、ハニーポット、50以上のリスクを検出します。
• 📖 コントラクト説明機能 — コントラクトを平易な英語で説明します。
• ⚡ プロテンプレート — フラッシュローン、アービトラージ、イールドアグリゲーターなどの事前構築済みのバンドルが利用できます。
• 🌙 ダーク/ライトモード — 目に優しい表示です。
• 📥 ZIPダウンロード — server.py、requirements.txt、README.mdを含む完全なサーバーがダウンロードできます。
• 🔗 共有リンク — ?address=0x...&network=ethereumを誰にでも送信できます。

📦 インストール

pip install abi-to-mcp

💻 使用例

基本的な使用法

# Uniswap — Claudeがトークンを交換できるようにする
abi-to-mcp generate 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D -o ~/uniswap-server

# ETH 2.0 Beacon Deposit — Claudeがステーキングを探索できるようにする
abi-to-mcp generate 0x00000000219ab540356cBB839Cbe05303d7705Fa -o ~/eth-staking-server

# 検証済みのコントラクトなら何でも動作します
abi-to-mcp generate <ANY_CONTRACT_ADDRESS>

高度な使用法

# 独自のコントラクトを使用する場合
abi-to-mcp generate ./my-contract-abi.json --address 0x... -o ~/my-server

📚 詳細ドキュメント

UCAI標準

UCAI（Universal Contract AI Interface）は、AIエージェントがスマートコントラクトとやり取りするための標準です。

╔═══════════════════════════════════════════════════════════════════════════════╗
║                                                                               ║
║   ┌─────────┐      ┌──────────────┐      ┌──────────────┐      ┌──────────┐   ║
║   │         │      │              │      │              │      │          │   ║
║   │  Claude │─────>│  abi-to-mcp  │─────>│  MCP Server  │─────>│  Chain   │   ║
║   │         │      │   generate   │      │ (your tools) │      │          │   ║
║   └─────────┘      └──────────────┘      └──────────────┘      └──────────┘   ║
║        │                                        │                     │       ║
║        │              "swap 1 ETH"              │    call swap()      │       ║
║        └────────────────────────────────────────┴─────────────────────┘       ║
║                                                                               ║
╚═══════════════════════════════════════════════════════════════════════════════╝

UCAIは以下を定義します

• 📋 ツールスキーマ — コントラクト関数をAIが呼び出せるツールに変換する方法。
• 🔄 型マッピング — Solidity → JSON Schema → Pythonの変換。
• 🔒 セーフティパターン — すべての状態変更には事前にシミュレーションを行います。
• 📡 イベントクエリ — 履歴データのアクセスパターン。

なぜUCAIが必要なのか

手動でMCPサーバーを作成するのは面倒で、エラーが発生しやすいため、UCAIを使用することで、1つのコマンドでいかなるABIからも本番環境で使用可能なMCPサーバーを生成できます。

使用例

• AIエージェントビルダー — エージェントにDeFiの機能（交換、貸付、投票など）を付与します。
• ウォレット開発者 — Claudeにトランザクションの説明と実行をさせます。
• DAOツール開発 — AIによる提案作成、投票、財務管理を行います。
• DeFiダッシュボード — オンチェーンデータの自然言語クエリを行います。
• Vibecoders — AIによるブロックチェーンツールを迅速に開発します。

実際の例

🦄 Uniswap: 自然言語でトークンを交換する

abi-to-mcp generate 0x7a250d5630B4cF539739dF2C5dAcb4c659F2488D -o ~/uniswap-server

Claudeに以下のように質問できます。

"What's the current rate for swapping 10 ETH to USDC?"

ClaudeはgetAmountsOut()を呼び出し、以下のように応答します。

"10 ETH → 38,472.31 USDC via the WETH/USDC pool. Want me to simulate the swap?"

🏦 Aave: ヘルスファクターを確認する

abi-to-mcp generate 0x87870Bca3F3fD6335C3F4ce8392D69350B4fA4E2 -o ~/aave-server

"What's my health factor on Aave? Am I at risk of liquidation?"

Claudeはあなたのポジションを読み取り、危険にさらされる前に警告します。

🎨 任意のNFT: コレクションを探索する

abi-to-mcp generate 0xBC4CA0EdA7647A8aB7C2061c2E118A18a936f13D -o ~/bayc-server

"Who owns BAYC #8817? How many apes does that wallet have?"

ClaudeはownerOf()とbalanceOf()を呼び出して回答します。

🔮 独自のコントラクト

abi-to-mcp generate ./my-contract-abi.json --address 0x... -o ~/my-server

検証済みのコントラクトやローカルのABIでも、1つのコマンドで動作します。

🔧 技術詳細

セキュリティスキャナー

Claudeをコントラクトに接続する前に、セキュリティスキャナーで50以上のリスクパターンを分析します。

+------------------------------------------------------------------------------+
|  SECURITY REPORT                                            Score: 42/100    |
+------------------------------------------------------------------------------+
|                                                                              |
|  CRITICAL                                                                    |
|  |-- Self-Destruct Function -- Contract can be destroyed                     |
|  +-- tx.origin Authentication -- Vulnerable to phishing                      |
|                                                                              |
|  HIGH                                                                        |
|  |-- Hidden Mint -- Owner can create unlimited tokens                        |
|  |-- Pausable -- Owner can freeze all transfers                              |
|  +-- Blacklist -- Owner can block specific addresses                         |
|                                                                              |
|  POSITIVES                                                                   |
|  |-- Contract verified on Etherscan                                          |
|  |-- Uses OpenZeppelin (audited library)                                     |
|  +-- Has reentrancy protection                                               |
|                                                                              |
|  [Proceed Anyway]                                     [Cancel -- Too Risky]  |
|                                                                              |
+------------------------------------------------------------------------------+

コントラクト説明機能

コントラクトが何をするのかわからない場合、コントラクト説明機能で平易な英語で説明します。

+------------------------------------------------------------------------------+
|  WHAT THIS CONTRACT DOES                                                     |
+------------------------------------------------------------------------------+
|                                                                              |
|  Summary: Uniswap V2 Router -- Decentralized token exchange                  |
|                                                                              |
|  Main Functions:                                                             |
|  |-- [R] getAmountsOut -- Calculate expected output for a swap               |
|  |-- [W] swapExactTokensForTokens -- Exchange tokens at market rate          |
|  |-- [W] addLiquidity -- Provide liquidity to earn fees                      |
|  +-- [R] getReserves -- Check pool balances                                  |
|                                                                              |
|  Permissions:                                                                |
|  |-- Anyone -- Can swap, add/remove liquidity                                |
|  +-- Factory -- Can create new pairs                                         |
|                                                                              |
|  Risk Summary:                                                               |
|  "Standard DEX router. No owner privileges. Interacts with external pools    |
|   which may have their own risks."                                           |
|                                                                              |
+------------------------------------------------------------------------------+

プロテンプレート

高度なユースケース用の事前構築済みのマルチコントラクトバンドルがあります。

各バンドルはZIP形式でダウンロードでき、以下のものが含まれています。

• 複数のserver.pyファイル（コントラクトごとに1つ）
• 事前構成済みのclaude_config.json
• 始めるためのサンプルプロンプト

生成されるもの

abi-to-mcpをコントラクトに適用すると、すべての関数とイベントを調べ、Claudeが呼び出せるツールを生成します。

コントラクトごとに15 - 30個のツールが生成され、完全に型付けされ、書き込み操作にはシミュレーションが保護されています。

CLIリファレンス

abi-to-mcp generate

ABIからMCPサーバーを生成します。

abi-to-mcp generate <source> [options]

引数:

• source: ABIファイルのパスまたはコントラクトアドレス

オプション:

• -o, --output PATH: 出力ディレクトリ（デフォルト: ./mcp-server）
• -n, --network TEXT: アドレス検索用のネットワーク（デフォルト: mainnet）
• -a, --address TEXT: コントラクトアドレス（ソースに含まれていない場合）
• --name TEXT: サーバー名（指定されていない場合は自動検出）
• --read-only: 読み取り操作のみを生成します。
• --no-events: イベントをリソースとして除外します。
• --no-simulate: 書き込み操作のシミュレーションをデフォルトで無効にします。

abi-to-mcp inspect

ファイルを作成せずに生成される内容をプレビューします。

abi-to-mcp inspect ./token-abi.json

abi-to-mcp validate

生成せずにABIを検証します。

abi-to-mcp validate ./token-abi.json

生成されるサーバーの構造

my-mcp-server/
├── server.py           # メインのMCPサーバー
├── config.py           # 設定ファイル
├── requirements.txt    # 依存関係
├── README.md           # ドキュメント
├── pyproject.toml      # パッケージ設定
└── .env.example        # 環境変数のテンプレート

型マッピング

環境変数

サポートされるネットワーク

📄 ライセンス

このプロジェクトはMITライセンスの下で公開されています。詳細はLICENSEを参照してください。

UCAI — ユニバーサルコントラクトAIインターフェース
あらゆるチェーン上のあらゆるコントラクトとAIを対話させましょう。

⭐ GitHubでスターをつける • 📦 PyPIからインストール • 🔌 MCPについて学ぶ