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 模式。