Chainfetch MCP Server

🚀 ChainFETCH MCP Server

ChainFETCH MCP Server 是一個模型上下文協議（MCP）服務器，可讓你訪問 ChainFETCH API。ChainFETCH 是一個由人工智能驅動的以太坊區塊鏈智能平臺，具備先進的語義搜索能力。

🚀 快速開始

ChainFETCH MCP Server 為用戶提供了訪問 ChainFETCH API 的途徑，該平臺結合了即時區塊鏈數據流與人工智能分析，為以太坊區塊鏈數據提供了強大的搜索和分析功能。你可以通過以下步驟快速開始使用該服務器。

✨ 主要特性

ChainFETCH 將即時區塊鏈數據流與人工智能分析相結合，提供以下功能：

• 🔥 即時區塊流：每約 12 秒進行一次以太坊區塊的即時處理。
• 🧠 人工智能語義搜索：使用 Qwen3-Embedding-0.6B 模型進行向量相似度搜索。
• 🤖 大語言模型增強查詢：使用 LLaMA 3.2 3B 模型進行智能參數選擇。
• ⚡ 多模式搜索：提供語義搜索、大語言模型搜索和 JSON 搜索選項。
• 🎯 全面覆蓋：涵蓋地址、交易、區塊、代幣和智能合約等信息。

📦 安裝指南

前提條件

• 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

💻 使用示例

基礎用法

語義搜索

// 查找鯨魚地址
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
})

自然語言查詢

// 基於大語言模型的地址搜索
search_addresses_llm({
  query: "Show me verified smart contracts deployed in the last month"
})

// 基於大語言模型的交易搜索
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"
})

// 獲取人工智能生成的摘要
get_address_summary({
  address_hash: "0x742D35Cc6335C06576BE5A1D5E2A7df9e7B0E8df"
})

📚 詳細文檔

可用工具

地址分析

• search_addresses_semantic - 人工智能向量相似度搜索
• search_addresses_json - 150 多個參數過濾
• search_addresses_llm - 自然語言到智能參數選擇
• get_address_summary - 人工智能生成的地址摘要
• get_address_info - 詳細的地址信息

交易智能

• search_transactions_semantic - 語義交易搜索
• search_transactions_json - 254 多個精心篩選的參數
• search_transactions_llm - 自然語言交易查詢
• get_transaction_summary - 人工智能交易摘要
• get_transaction_info - 詳細的交易數據

區塊分析

• search_blocks_semantic - 人工智能區塊搜索
• search_blocks_json - 120 多個區塊參數
• search_blocks_llm - 自然語言區塊查詢
• get_block_summary - 人工智能區塊摘要
• get_block_info - 詳細的區塊信息

代幣智能

• search_tokens_semantic - 語義代幣搜索
• search_tokens_json - 全面的代幣過濾
• search_tokens_llm - 自然語言代幣查詢
• get_token_summary - 人工智能代幣摘要
• get_token_info - 詳細的代幣信息
• get_nft_instance_info - NFT 實例詳情

智能合約分析

• search_smart_contracts_semantic - 人工智能合約搜索
• search_smart_contracts_json - 50 多個合約參數
• search_smart_contracts_llm - 自然語言合約查詢
• get_smart_contract_summary - 人工智能合約摘要
• get_smart_contract_info - 詳細的合約信息

API 覆蓋範圍

此 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 文檔
• API 訪問：獲取 API 令牌
• 問題反饋：GitHub 問題

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE 文件。

🔧 技術細節

版本更新日誌

v1.0.0

• 初始版本發佈。
• 完整集成 ChainFETCH API。
• 支持語義搜索、大語言模型搜索和 JSON 搜索模式。
• 提供地址、交易、區塊、代幣和智能合約工具。
• 支持 Claude Desktop 和 ngrok HTTP 模式。