# Hermes Blockchain Oracle

> 仓库地址：https://github.com/gizdusum/hermes-blockchain-oracle
> 作者/组织：gizdusum
> 成熟度：experimental
> 分析日期：2026-04-15

## 一句话总结
一个 MCP server，为 Hermes Agent 提供自然语言查询 Solana 链上数据的能力，覆盖钱包、交易、NFT、whale detection 和网络状态。

## 项目定位与架构
hermes-blockchain-oracle 将 Solana 区块链数据接入 Hermes Agent 的对话界面——用户说"Check this wallet's SOL balance"，LLM 自动选择合适的工具执行链上查询。

三层架构：User Interface Layer → Hermes Agent (MCP 路由) → Oracle Server (Solana RPC calls + 响应格式化) → Blockchain Layer (链上数据)。MCP 协议处理工具发现、schema 协商、请求路由和响应格式化。

技术栈：Python 3.10+，Solana mainnet-beta，MCP 协议，默认端口 8420，30 秒 cache TTL。

## 关键技术特性
- **7 个 Solana 工具**：wallet info（SOL 余额+token holdings）、transaction decode、token info（元数据+供应量+持有者数）、recent activity、NFT portfolio、whale detector、network stats
- **自然语言查询**：LLM 自动选择工具，无需手动区块链操作
- **Whale Detection**：可配置阈值（默认 1000 SOL / $100k USD）
- **缓存机制**：30 秒 cache TTL 减少 RPC 调用
- **pip 安装**：`pip install hermes-blockchain-oracle`
- **Hermes 集成**：`hermes-agent --mcp blockchain=hermes-blockchain-oracle`

## 设计亮点与创新
通过 MCP 协议将区块链数据暴露为 LLM 可调用的工具，是一种优雅的集成模式——不需要用户理解 Solana RPC API，自然语言即可查询链上数据。whale detector 工具的实用价值较高。环境变量可配置 RPC endpoint 和各项阈值。

## 局限性与风险
依赖 RPC endpoint 可用性和 rate limits。Whale detection 阈值运行时固定。30 秒全局 cache 可能导致数据延迟。仅支持 Solana（不含 Ethereum 等其他链）。NFT 元数据依赖链上索引准确性。无历史趋势分析能力（仅当前快照）。

## 与生态系统的关联
展示了 MCP 协议在垂直领域集成中的力量——与 vessel-browser（MCP 暴露浏览器控制）、nemohermes（MCP 暴露 NVIDIA GPU 路由）形成 MCP 工具生态的不同垂直切面。对 Web3/DeFi 场景的 Hermes Agent 用户有直接价值。