universal-blockchain

Universal Blockchain MCP

AI アシスタントを通じて ZetaChain CLI、Foundry、クロスチェーン機能にフルアクセスできる、ユニバーサルなブロックチェーン開発向けの包括的な Model Context Protocol（MCP）サーバーです。

機能

🔐 アカウント管理

• create_account: ニーモニックフレーズを使用して新しい ZetaChain アカウントを作成します
• import_account: 秘密鍵またはニーモニックを使用して既存のアカウントをインポートします
• list_accounts: 利用可能なすべての ZetaChain アカウントを一覧表示します
• show_account: アカウントの詳細情報を表示します

💰 残高とトークン操作

• get_balances: チェーン全体のネイティブトークンと ZETA トークンの残高を取得します
• list_tokens: すべての ZRC-20 トークンをアドレスおよびチェーン情報とともに一覧表示します
• request_faucet: フォーセットからテストネット用 ZETA トークンをリクエストします

🌐 クロスチェーン操作

• query_cctx: クロスチェーン取引データをリアルタイムで照会します
• get_fees: オムニチェーンおよびクロスチェーンメッセージングの手数料を取得します
• call_contract: ZetaChain から接続済みチェーン上のコントラクトを呼び出します
• withdraw_tokens: ZetaChain から接続済みチェーンへトークンを出金します
• withdraw_and_call: 1 回の操作でトークンを出金し、コントラクトを呼び出します

⛓️ ネットワークとチェーン情報

• list_chains: サポートされているすべてのチェーンを ID およびトークン数とともに一覧表示します
• get_network_info: 現在の ZetaChain ネットワークのステータスと情報を取得します

🛠️ 開発ツール

• create_project: テンプレートを使用して新しいユニバーサルコントラクトプロジェクトを作成します
• check_foundry: Foundry（forge、cast、anvil）のインストール状況とバージョンを確認します

🔧 高度なツール（65 以上を利用可能）

• Foundry 統合: forge_build、forge_test、forge_create、forge_verify
• Cast 操作: cast_call、cast_send、cast_balance、cast_nonce、cast_gas_price
• Anvil テスト: anvil_start、anvil_snapshot、anvil_revert
• ZetaChain 高度機能: validator_create、governance_vote、staking_delegate、staking_rewards
• クロスチェーン: cross_chain_send、cross_chain_status、bridge_status
• スマートコントラクト: contract_compile、contract_deploy、contract_interact
• DeFi 操作: defi_swap、defi_liquidity_add、defi_yield_farm
• NFT 操作: nft_mint、nft_transfer、nft_metadata
• ウォレット管理: wallet_export、wallet_backup、transaction_history
• セキュリティと分析: security_audit、gas_optimizer、multisig_create
• ブロックチェーンツール: block_explorer、gas_tracker、portfolio_tracker

Note: 高度なツールは、NPM 経由でローカルにインストールするとフル機能を利用できます。クラウド版では、役立つガイダンスとインストール手順を提供します。

インストール

🚀 方法 1: NPM パッケージ（フル機能の利用を推奨）

自動セットアップ付きワンクリックインストール:

npm install -g @ExpertVagabond/universal-blockchain-mcp

以下が自動的にインストールされます：

• ✅ ZetaChain CLI（グローバル）
• ✅ Foundry ツールキット（forge、cast、anvil）
• ✅ 65 以上の MCP ツール（すべての機能を利用可能）
• ✅ 完全な開発環境

インストール後の使用方法:

# Run the MCP server
universal-blockchain-mcp

# Or use with Claude Desktop
# Add to Claude Desktop config:
{
  "mcpServers": {
    "universal-blockchain": {
      "command": "universal-blockchain-mcp",
      "args": []
    }
  }
}

🌐 方法 2: Smithery Cloud（ホスト型）

Claude Code CLI:

claude mcp add --transport http universal-blockchain "https://server.smithery.ai/@ExpertVagabond/universal-blockchain-mcp/mcp"

ディープリンク（HTTP）:

claude://mcp/install?name=Universal%20Blockchain%20MCP&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fserver.smithery.ai%2F%40ExpertVagabond%2Funiversal-blockchain-mcp%2Fmcp%22%7D

手動設定:

{
  "type": "http",
  "url": "https://server.smithery.ai/@ExpertVagabond/universal-blockchain-mcp/mcp"
}

Smithery レジストリ:

# Install via Smithery registry
SMITHERY_API_KEY=your_key smithery run @ExpertVagabond/universal-blockchain-mcp

📦 方法 3: その他の MCP レジストリ

mcp.so レジストリ:

• https://mcp.so にアクセス
• 「universal-blockchain-mcp」を検索
• ワンクリックでインストールできます

PulseMCP ディレクトリ:

• https://pulsemcp.com にアクセス
• ブロックチェーンと Web3 のカテゴリを参照
• Cursor、Claude、Cline と直接統合できます

Glama レジストリ:

• https://glama.ai にアクセス
• 「ZetaChain」または「blockchain」を検索
• 複数ツールのエコシステムと統合できます

Fleur（Mac + Claude）:

• https://fleur.ai にアクセス
• コード不要で MCP をインストールできます
• 技術に詳しくないユーザーに最適です

🔧 方法 4: 手動設定

stdio 設定（ローカル）:

{
  "type": "stdio", 
  "command": "npx",
  "args": ["-y", "@ExpertVagabond/universal-blockchain-mcp"]
}

カスタム CLI パス:

{
  "type": "stdio",
  "command": "/path/to/universal-blockchain-mcp",
  "args": []
}

手動インストール

前提条件

• Node.js 18+
• ZetaChain CLI（自動的にインストールされます）
• Foundry（スマートコントラクト開発用。自動的にインストールされます）

クイックセットアップ

# Clone and setup everything
git clone https://github.com/ExpertVagabond/zetachain-mcp-server.git
cd zetachain-mcp-server
npm run setup  # Installs dependencies, CLI, and builds project

手動セットアップ

# 1. Clone repository
git clone https://github.com/ExpertVagabond/zetachain-mcp-server.git
cd zetachain-mcp-server

# 2. Install dependencies (includes ZetaChain CLI via npm)
npm install

# 3. Install ZetaChain CLI globally (optional, recommended)
npm install -g zetachain@latest

# 4. Build the project
npm run build

# 5. Run the server
npm start

ZetaChain のローカルインストールを使用する

ZetaChain CLI がローカルにインストールされている場合は、パスを指定できます。

export ZETACHAIN_CLI_PATH=/path/to/zetachain
npm start

開発

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Start production server
npm start

使用例

Claude に追加すると、自然言語を通じて ZetaChain のすべての機能を使用できます。

アカウント管理

Create a new ZetaChain account called "my-wallet"
Import my existing account using this private key: 0x...
Show me all my ZetaChain accounts

クロスチェーン操作

Check ZETA balances for address 0x742d35Cc6634C0532925a3b8D5C20aE6f0f3FFaa
What are the current cross-chain fees from Ethereum to Polygon?
Query the status of cross-chain transaction 0xabc123...
Withdraw 100 ZETA from ZetaChain to Ethereum address 0x...

トークンとチェーンの情報

List all supported chains on ZetaChain
Show me all ZRC-20 tokens
What tokens are available on BSC testnet?

開発

Create a new ZetaChain project called "my-dapp" 
Get testnet ZETA tokens for address 0x...
What's the current ZetaChain testnet status?

対応チェーン

ZetaChain MCP サーバーは、ZetaChain に接続されているすべてのチェーンに対応しています。

• Ethereum（Sepolia Testnet）
• BSC（Testnet）
• Polygon（Amoy Testnet）
• Avalanche（Fuji Testnet）
• Arbitrum（Sepolia）
• Base（Sepolia）
• Bitcoin（Testnet/Signet）
• Solana（Devnet）
• TON（Testnet）
• Sui（Testnet）
• Kaia（Testnet）

要件

• Node.js 18+
• ZetaChain CLI（依存関係として自動的にインストールされます）
• Foundry（スマートコントラクト開発用。自動的にインストールされます）

アーキテクチャ

この MCP サーバーは、AI アシスタントと ZetaChain CLI の間のブリッジとして機能し、次のことを可能にします。

• CLI との直接統合：すべてのコマンドは公式の ZetaChain CLI を通じて実行されます
• リアルタイムデータ：ZetaChain ネットワークからのライブブロックチェーンデータ
• クロスチェーン機能：ZetaChain のオムニチェーン機能にフルアクセスできます
• 開発者向けツール：プロジェクト作成、アカウント管理、テスト用ユーティリティ

ライセンス

MIT