🚀 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 进行测试
- 设置你的 API 令牌。
- 配置 Claude Desktop 或使用 ngrok。
- 首先使用简单查询进行测试。
- 使用语义搜索进行探索性分析。
支持
- 文档：ChainFETCH API 文档
- API 访问：获取 API 令牌
- 问题反馈：GitHub 问题
📄 许可证
本项目采用 MIT 许可证，详情请参阅 LICENSE 文件。
🔧 技术细节
版本更新日志
v1.0.0
- 初始版本发布。
- 完整集成 ChainFETCH API。
- 支持语义搜索、大语言模型搜索和 JSON 搜索模式。
- 提供地址、交易、区块、代币和智能合约工具。
- 支持 Claude Desktop 和 ngrok HTTP 模式。