Chainfetch MCP Server

🚀 ChainFETCH MCP Server

ChainFETCH MCP Serverは、高度な意味検索機能を備えたAIパワードのイーサリアムブロックチェーンインテリジェンスプラットフォームであるChainFETCH APIへのアクセスを提供する、Model Context Protocol (MCP)サーバーです。

✨ 主な機能

ChainFETCHは、リアルタイムのブロックチェーンストリーミングとAIパワードの分析を組み合わせて、以下の機能を提供します。

• 🔥 ライブブロックストリーミング：約12秒ごとのリアルタイムイーサリアムブロック処理
• 🧠 AIパワードの意味検索：Qwen3-Embedding-0.6Bモデルを使用したベクトル類似性検索
• 🤖 LLM強化クエリ：インテリジェントなパラメータ選択のためのLLaMA 3.2 3Bモデル
• ⚡ マルチモーダル検索：意味、LLM、JSON検索オプション
• 🎯 包括的なカバレッジ：アドレス、トランザクション、ブロック、トークン、スマートコントラクト

📦 利用可能なツール

アドレス分析

• search_addresses_semantic - AIパワードのベクトル類似性検索
• search_addresses_json - 150以上のパラメータフィルタリング
• search_addresses_llm - 自然言語からのスマートパラメータ選択
• get_address_summary - AI生成のアドレス概要
• get_address_info - 詳細なアドレス情報

トランザクションインテリジェンス

• search_transactions_semantic - 意味トランザクション検索
• search_transactions_json - 254以上の精選されたパラメータ
• search_transactions_llm - 自然言語トランザクションクエリ
• get_transaction_summary - AIトランザクション概要
• get_transaction_info - 詳細なトランザクションデータ

ブロック分析

• search_blocks_semantic - AIパワードのブロック検索
• search_blocks_json - 120以上のブロックパラメータ
• search_blocks_llm - 自然言語ブロッククエリ
• get_block_summary - AIブロック概要
• get_block_info - 詳細なブロック情報

トークンインテリジェンス

• search_tokens_semantic - 意味トークン検索
• search_tokens_json - 包括的なトークンフィルタリング
• search_tokens_llm - 自然言語トークンクエリ
• get_token_summary - AIトークン概要
• get_token_info - 詳細なトークン情報
• get_nft_instance_info - NFTインスタンスの詳細

スマートコントラクト分析

• search_smart_contracts_semantic - AIコントラクト検索
• search_smart_contracts_json - 50以上のコントラクトパラメータ
• search_smart_contracts_llm - 自然言語コントラクトクエリ
• get_smart_contract_summary - AIコントラクト概要
• get_smart_contract_info - 詳細なコントラクト情報

📦 インストール

前提条件

• Node.js 18.0.0以上
• chainfetch.appから取得したChainFETCH APIトークン

オプション1: NPMインストール（推奨）

npm install -g chainfetch-mcp-server

オプション2: ソースからインストール

git clone https://github.com/chainfetch/chainfetch-mcp-server.git
cd chainfetch-mcp-server
npm install
npm run build
npm link

📚 設定

環境変数

ChainFETCH APIトークンを設定します。

export CHAINFETCH_API_TOKEN="your_api_token_here"

Claude Desktop用

Claude Desktopの設定ファイルに追加します。

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "chainfetch": {
      "command": "npx",
      "args": ["chainfetch-mcp-server"],
      "env": {
        "CHAINFETCH_API_TOKEN": "CHAINFETCH_API_TOKEN"
      }
    }
  }
}

ngrok経由のClaude（HTTPモード）用

HTTPモードでサーバーを起動します。

MCP_HTTP_MODE=true chainfetch-mcp-server

別のターミナルで、ngrokを起動します。

ngrok http 8000

Claude MCPコネクタを以下の設定で構成します。

• サーバーURL: https://your-ngrok-url.ngrok.app/streamable-http
• APIキー: あなたのChainFETCH APIトークン

💻 使用例

意味検索

// ウェールアドレスを検索
search_addresses_semantic({
  query: "whale addresses with high ETH balance and DeFi activity",
  limit: 10
})

// 疑わしいトランザクションを検索
search_transactions_semantic({
  query: "high gas transactions with failed status",
  limit: 5
})

自然言語クエリ

// LLMパワードのアドレス検索
search_addresses_llm({
  query: "Show me verified smart contracts deployed in the last month"
})

// LLMパワードのトランザクション検索
search_transactions_llm({
  query: "Find large value transfers between exchanges"
})

構造化フィルタリング

// 特定のパラメータでJSON検索
search_addresses_json({
  eth_balance_min: "10.0",
  is_contract: true,
  is_verified: true,
  transactions_count_min: 1000,
  limit: 20
})

詳細分析

// 包括的なアドレス情報を取得
get_address_info({
  address: "0x742D35Cc6335C06576BE5A1D5E2A7df9e7B0E8df"
})

// AI生成の概要を取得
get_address_summary({
  address_hash: "0x742D35Cc6335C06576BE5A1D5E2A7df9e7B0E8df"
})

📚 ドキュメント

このMCPサーバーは、ChainFETCHの包括的なAPIへのアクセスを提供します。

• 150以上のアドレスパラメータ：残高、コントラクトステータス、トランザクション数、トークン保有量
• 254以上のトランザクションパラメータ：価値、ガス、アドレス、ブロック情報、トークン転送
• 120以上のブロックパラメータ：高さ、ガス使用量、トランザクション数、マイナー情報
• トークン分析：ERC-20、ERC-721、ERC-1155のサポートとメタデータ
• スマートコントラクトインテリジェンス：検証ステータス、プロキシパターン、ABI分析

🔧 エラーハンドリング

サーバーは、一般的な問題に対する詳細なエラーメッセージを提供します。

• APIトークンが欠落している
• 無効なアドレス/ハッシュ
• レート制限
• ネットワーク接続の問題

🔧 開発

ローカル開発

# 依存関係をインストール
npm install

# 開発モードで実行
npm run dev

# テスト用にHTTPモードで実行
npm run dev:http

Claudeでのテスト

1. APIトークンを設定する
2. Claude Desktopを設定するか、ngrokを使用する
3. まずは簡単なクエリでテストする
4. 探索的分析に意味検索を使用する

📚 サポート

• ドキュメント: ChainFETCH API Docs
• APIアクセス: Get API Token
• 問題報告: GitHub Issues

📄 ライセンス

MITライセンス - 詳細はLICENSEファイルを参照してください。

📚 変更履歴

v1.0.0

• 初回リリース
• 完全なChainFETCH API統合
• 意味、LLM、JSON検索モード
• アドレス、トランザクション、ブロック、トークン、スマートコントラクトツール
• Claude Desktopとngrok HTTPのサポート