DuckChain MCP 服务器
一个全面的模型上下文协议（MCP）服务器，通过BlockScout API v2规范提供对区块链数据的完整访问。DuckChain使AI助手能够进行深入的区块链分析，包括交易追踪、地址探索、代币管理、智能合约分析以及使用56+种专业工具进行的全面市场调研。
特点/特性
🔍 搜索与发现
- 区块链搜索搜索地址、代币、区块或交易
- 搜索重定向检查查询是否应重定向到特定页面
📊 交易分析
- 交易详情通过哈希获取完整的交易信息
- 交易过滤按状态、类型或方法筛选交易
- 代币转账检索特定交易的代币转账详情
- 内部交易访问特定交易的内部交易数据
- 事务日志获取详细的交易日志以进行分析
- 原始轨迹访问原始交易追踪数据
- 状态变化监控由事务引起的状态变化
- 交易概要获取简洁的交易摘要
🧱 块操作
- 数据块访问块信息，并可选择性地进行类型过滤
- 区块详情通过区块号或哈希获取特定区块的详细信息
- 阻止交易检索特定区块中的所有交易
- 阻止提款获取特定区块的撤销数据
- 主页模块获取优化后适合主页面展示的模块/区块
🏠 地址分析
- 地址详情获取完整的地址信息
- 处理事务（或：处理交易）访问特定地址的所有交易
- 代币余额检查任意地址的代币余额
- 余额历史追踪随时间变化的硬币余额
- NFT管理访问地址的NFT数据和集合
- 地址计数器获取交易和活动计数器
- 已验证区块查看由特定地址验证的区块
- 提现历史跟踪撤资活动
💰 代币操作
- 令牌管理完整的令牌生命周期管理
- 代币详情获取全面的代币信息
- 代币转账访问所有代币转账数据
- 代币持有者分析代币分配和持有者情况
- 令牌实例管理令牌实例和元数据
- 代币计数器追踪代币活动统计
- 元数据刷新更新令牌实例元数据
📜 智能合约分析
- 合同详情获取全面的智能合约信息
- 合同清单浏览所有智能合约
- 合同计数器追踪智能合约活动
- 合同分析分析合同交互与使用情况
📈 统计与图表
- 区块链统计获取全面的区块链统计数据
- 交易图表访问交易量和活动数据
- 市场图表获取价格和成交量的可视化数据
🔧 内部运营
- 内部交易访问内部交易数据
- 索引状态监控区块链索引进度
🚀 最新更新
完整的API覆盖
- 56+ MCP 工具 覆盖所有BlockScout API v2终端点
- 高级交易分析 带有日志、追踪和状态变化
- 全面地址分析 包括NFT和余额历史
- 全面的代币管理 带有实例和元数据刷新
- 智能合约分析 附有详细的合同信息
- 深度模块分析 包括提现和交易详情
增强的能力
- 无需认证 - 开箱即用
- 类型安全的实现 - 完整的Pydantic验证
- 全面的错误处理 - 用户友好的错误信息
- 异步性能 - 快速、非阻塞操作
- 模块化设计 - 易于扩展和维护
先决条件
- Smithery API密钥获取您的（产品/服务）请访问 smithery.ai/账户/API密钥
- Python 3.10 或更高版本
支持的网络
DuckChain支持所有与BlockScout兼容的网络，包括：
- 以太坊主网 (
blockscout.com/eth/mainnet) - 多边形 （
blockscout.com/matic/mainnet) - BSC（基站控制器） (
blockscout.com/bsc/mainnet） - Arbitrum（注：这是一个区块链平台或技术的名称，直接翻译可能无法准确传达其含义，但在此处按字面意思翻译为“仲裁者”或保持原名以体现其专业性） （
blockscout.com/arbitrum/mainnet) - 乐观主义 (
blockscout.com/optimism/mainnet） - 雪崩 (
blockscout.com/avax/mainnet) - Fantom（通常指一种加密货币或区块链平台，具体翻译可能根据上下文有所调整，但在此直接音译为“范特姆”） (
blockscout.com/ftm/mainnet) - Gnosis Chain（吉诺西链） (
blockscout.com/gnosis/mainnet） - POA Core（核心） （
blockscout.com/poa/core- 默认
入门指南/开始使用
- 安装依赖项：
uv sync- 运行服务器:
uv run dev- 交互式测试:
uv run playground无需身份验证
- 免费且公开访问 - 大多数BlockScout实例都是免费且公开的
- 无需API密钥 - DuckChain无需任何认证即可运行
- 简单设置 - 只需配置服务器URL，即可准备就绪
使用示例
搜索行动
Search for USDT token information
Search for address 0x1234...
Find block 12345678交易分析
Get transaction details for 0xabc123...
Get token transfers for transaction 0xdef456...
Get internal transactions for transaction 0xdef456...
Get transaction logs for 0xdef456...
Get raw trace for transaction 0xdef456...
Get state changes for transaction 0xdef456...
Get transaction summary for 0xdef456...
Filter transactions by method "transfer"区块分析
Get block details for block 12345678
Get all transactions in block 12345678
Get withdrawals for block 12345678
Get blocks with type filtering地址分析
Get address details for 0x1234...
Get all transactions for address 0x1234...
Get token balances for address 0x1234...
Get coin balance history for address 0x1234...
Get NFT collections for address 0x1234...
Get blocks validated by address 0x1234...令牌管理
Get token details for 0xabc123...
Get token holders for 0xabc123...
Get token transfers for 0xabc123...
Get token instances for 0xabc123...
Refetch token instance metadata智能合约分析
Get smart contract details for 0xdef456...
Get smart contracts list
Get smart contract counters市场调研
Get blockchain statistics
Show transaction chart data
Display market chart for price analysis可用工具
搜索工具
search_blockchain搜索地址、代币、区块或交易check_search_redirect检查搜索是否应重定向到特定页面
交易工具
get_transactions获取带有过滤选项的交易get_transaction_details获取详细的交易信息get_transaction_token_transfers获取交易中的代币转账信息get_transaction_internal_transactions获取某笔交易的内部交易记录get_transaction_logs获取某笔交易的日志get_transaction_raw_trace获取事务的原始跟踪信息get_transaction_state_changes获取事务的状态变化get_transaction_summary获取交易摘要
区块工具
get_blocks获取区块，可选类型过滤get_block_details通过区块号或哈希获取特定区块的详细信息get_block_transactions获取特定区块的交易get_block_withdrawals获取特定区块的提现记录
地址工具
get_addresses_list获取地址列表get_address_details通过哈希获取地址详情get_address_counters获取地址计数器get_address_transactions获取特定地址的交易记录get_address_token_transfers获取特定地址的代币转账记录get_address_internal_transactions获取特定地址的内部交易get_address_logs获取特定地址的日志get_address_blocks_validated获取由特定地址验证的区块get_address_token_balances获取特定地址的代币余额get_address_tokens为特定地址获取代币get_address_coin_balance_history获取特定地址的代币余额历史get_address_coin_balance_history_by_day获取特定地址的每日代币余额历史记录get_address_withdrawals获取特定地址的提现记录get_address_nft获取特定地址的NFTget_address_nft_collections获取特定地址的NFT收藏品
代币工具
get_token_transfers获取所有代币转账记录get_tokens_list获取代币列表get_token_details通过地址哈希获取代币详情get_token_transfers_by_token获取特定代币的转账记录get_token_holders获取特定代币的持有者get_token_counters获取特定代币的计数器get_token_instances获取特定标记的实例get_token_instance_details获取特定令牌实例的详细信息get_token_instance_transfers获取特定代币实例的转账记录get_token_instance_holders获取特定代币实例的持有者get_token_instance_transfers_count获取特定代币实例的转账次数refetch_token_instance_metadata_tool为特定代币实例重新获取元数据
智能合约工具
get_smart_contracts_list获取智能合约列表get_smart_contracts_counters获取智能合约计数器get_smart_contract_details通过地址哈希获取智能合约详情
内部工具
get_internal_transactions获取内部交易
主页工具
get_main_page_transactions获取主页的交易数据get_main_page_blocks获取主页模块get_indexing_status获取区块链索引状态
统计工具
get_blockchain_stats获取区块链统计数据get_transactions_chart获取交易图表数据get_market_chart获取市场图表数据
资源
duckchain://api-docs完整的API文档duckchain://supported-chains支持的区块链网络列表
提示
analyze_transaction为交易生成分析提示explore_address为地址生成探索提示research_token为代币生成研究提示
发展
服务器代码位于 src/duckchain/server.py实现遵循BlockScout API v2规范，并提供了全面的错误处理和类型安全。
关键组件
- DuckChainAPI（鸭链API）用于BlockScout API的异步HTTP客户端，包含56+个端点
- ConfigSchema（配置模式/配置架构）用于配置验证的 Pydantic 模型
- MCP 工具56+个独立工具，涵盖所有主要区块链操作
- 资源文档和参考资料
- 提示针对常见区块链分析任务的预构建提示
API覆盖率
- 搜索与发现2个工具
- 交易分析8种工具（包括日志、轨迹、状态变化）
- 区块操作4种工具（包括撤资和详细分析）
- 地址分析15种工具（包含全面的地址数据和历史记录）
- 令牌管理12个工具（包括实例和元数据）
- 智能合约分析3个工具
- 统计与图表3个工具
- 内部运营1个工具
- 主页数据3个工具
总计：56+个MCP工具，涵盖完整的BlockScout API v2规范
部署
准备好部署了吗？将你的代码推送到GitHub，然后部署到Smithery：
- 将您的服务器部署到Smithery上 smithery.ai/new 翻译为中文是：“smithery.ai的新页面”或“smithery.ai的新增内容”。不过，具体翻译可能需要根据该网站的实际内容和上下文来调整，以更准确地传达其含义。在这里，“new”通常表示网站上的新页面、新功能或新内容
许可证
此项目采用Apache 2.0许可证授权 - 详见 许可证 详情请参阅文件。
做出贡献
欢迎贡献！请随时提交拉取请求。
支持
如需支持或有任何问题，请在GitHub上提交一个议题或联系DuckChain团队。