pythia-oracle-mcp

Pythia Oracle MCP 服务

每个智能合约都值得拥有洞察力，而不只是数据。

Pythia 是首个在链上提供计算型技术指标的预言机——EMA、RSI、VWAP、布林带、波动率，适用于任何 Chainlink 支持的链上的任何代币。交易者使用的相同指标，智能合约和 AI Agent 只需通过 Chainlink 调用一次即可获取。

Pythia Events 让智能合约能够订阅指标条件（RSI 低于 30、EMA 交叉、布林带突破），并在条件触发时自动获得调用。无需 keeper、无需链下机器人、无需轮询——合约可自行响应市场变化。

Pythia Visions 在链上提供经过逐步前推验证的市场洞察——一次事件即可包含模式类型、置信度分数、指标快照和用于确认的关注数据源。基于 9 年历史数据进行回测。订阅免费。如需查看当前的实时代币和模式目录及其准确率统计和触发频率，请调用下方 MCP 工具中的 get_visions_info。

为什么选择 Pythia？

大多数预言机只提供价格。Pythia 提供计算分析：EMA、RSI、布林带、VWAP、波动率——适用于 BTC、SOL、TAO、RENDER、ONDO、AAVE、UNI 等代币，覆盖 4 个时间周期，并通过 Chainlink 在链上交付。可按需添加新代币和指标。如果你的 AI Agent、DeFi 协议或交易机器人需要链上 RSI、EMA 或布林带，Pythia 是唯一的数据源。

使用场景：

• 需要链上技术信号的 AI 交易 Agent
• 基于 RSI 或波动率阈值进行再平衡的 DeFi 金库
• 使用布林带宽度进行风险管理的智能合约
• 利用实时计算指标进行 AI 投资组合分析
• 事件驱动策略——订阅 RSI 阈值或 EMA 交叉，合约会自动触发
• 无需 keeper 的自动化 DeFi 机器人——无需 Gelato、cron 作业或链下基础设施

快速开始

pip install pythia-oracle-mcp

Claude Desktop

添加到 claude_desktop_config.json：

{
  "mcpServers": {
    "pythia-oracle": {
      "command": "pythia-oracle-mcp"
    }
  }
}

Claude Code

claude mcp add pythia-oracle -- pythia-oracle-mcp

Cursor / Windsurf / VS Code

添加到 MCP 设置：

{
  "pythia-oracle": {
    "command": "pythia-oracle-mcp"
  }
}

OpenAI Agents / GPT

任何兼容 MCP 的客户端都可以使用——只需将其指向 pythia-oracle-mcp。

直接运行

python -m pythia_oracle_mcp

可用工具

工具	描述
list_tokens	所有已跟踪代币的状态、运行时间和数据源
get_token_feeds	特定代币的所有指标馈送名称
get_market_summary	全系统概览——按状态划分的代币、生态覆盖范围、基础设施运行状况
check_oracle_health	每种代币过去 30 天的运行时间（按最差到最好排序）、数据源状态、事件报告
get_contracts	所有合约地址（运营方、消费者、水龙头、LINK）
get_pricing	定价层级及各层级的适用场景
get_integration_guide	适用于任意层级、可直接部署的 Solidity 代码
get_events_info	Pythia Events 的工作方式——订阅指标条件，并在链上触发
get_events_guide	事件订阅的 Solidity 代码和部署步骤
subscribe_info	订阅详情——条件、定价、退款机制
get_visions_info	Pythia Visions 概览——经滚动前向验证的模式、触发频率说明、合约地址
get_visions_guide	订阅 Visions 并监听 VisionFired 事件的 Solidity 代码
get_vision_history	某代币近期触发的 Visions，包含模式分类和置信度统计
get_vision_payload	已触发 Vision 的完整增强对象——失败概况、冷却上下文、并发触发情况
lookup_event_feed	将 Event feedId（bytes32）反向查找为人类可读的馈送名称
list_subscriptions	列出某个所有者地址的所有活跃 Pythia Event 订阅
get_feed_value	任意 Pythia 指标馈送的最新计算值（链下缓存）
get_indicator_history	读取某馈送在日期范围内免费且不可变的公开历史（每次调用 ≤31 天）——逐日覆盖情况 + 可选的 ABOVE/BELOW 判定（TRUE / FALSE / INSUFFICIENT_DATA），并提供精确的每日文件 URL，方便任何人重新验证

示例提示词

向你的 AI Agent 提问：

“Pythia 为 Bitcoin 提供哪些指标？”

调用 get_token_feeds("bitcoin")——返回 Bitcoin 的所有指标馈送，并按类型分组。

“Pythia 可靠到足以集成吗？”

调用 check_oracle_health()——返回每种代币的运行时间、数据源运行状况和活跃事件。

“给我一份用于使用 Pythia speed bundle 的 Solidity 合约”

调用 get_integration_guide("speed")——返回包含正确地址和作业 ID 的完整可部署合约。

“Pythia 覆盖哪些代币？它们是否都在正常运行？”

调用 get_market_summary()——返回生态覆盖范围、状态分类和基础设施运行状况。

“Pythia Events 如何运作？我想让合约在 BTC RSI 跌破 30 时作出响应。”

调用 get_events_info()——返回订阅的工作方式、支持的条件和定价。

“给我订阅 EMA 交叉事件的 Solidity 代码。”

调用 get_events_guide()——返回采用 subscribe/receive 模式、可部署的 EventSubscriber 合约。

“什么是 Pythia Visions？它能检测哪些模式？”

调用 get_visions_info()——返回经滚动前向验证的模式及其准确率范围、触发频率、合约地址和工作方式。

“给我看看近期触发的 BTC Visions”

调用 get_vision_history("BTC")——返回近期模式检测结果及其置信度和价格。

“给我订阅 Pythia Visions 的 Solidity 代码”

调用 get_visions_guide()——返回订阅 VisionFired 事件的合约。

Pythia 提供的功能

• 任意代币，任意 Chainlink 支持的链 — 目前提供 BTC、SOL、TAO、RENDER、ONDO、AAVE、UNI、MORPHO 等代币的数据，并可按需添加新代币
• 6 种指标类型： EMA、RSI、布林带（上轨/下轨）、VWAP、波动率、美元价格
• 4 种时间周期： 5 分钟、1 小时、1 天、1 周
• 4 种定价层级： Discovery / Analysis / Speed / Complete — 当前 LINK 费用请调用 get_pricing
• 免费试用： PythiaFaucet 合约 — 无需 LINK
• Pythia Events： 订阅指标条件（高于/低于阈值）——触发时会调用你的合约。费用以 LINK 预付，取消或触发时退还未使用时长。无需 Keeper 基础设施。
• Pythia Visions： 经滚动前向验证的链上市场情报 — 通过 Chainlink 交付模式类型 + 置信度 + 指标快照 + 需关注的数据源。免费订阅。实时模式与代币列表请调用 get_visions_info。
• 公开指标历史记录： 免费、不可变的 JSON 归档，包含每个已发布的指标值 — 每个数据源在每个已结束的 UTC 日期对应一个文件，位于 https://pythia.c3x-solutions.com/history/{chain}/{feed_name}/{YYYY-MM-DD}.json（从 history/manifest.json 开始）。无需调用预言机，即可在指定日期范围内重新推导或审计任何指标条件；文件发布后永不更改。

数据时效性

此 MCP 服务是对 https://pythia.c3x-solutions.com/feed-status.json 的轻量客户端。该实时状态数据源由数据引擎每 15 分钟更新一次。新代币、新模式、合约地址和定价变更会在下一次数据引擎周期后的几秒内显示在 MCP 工具中，无需更新软件包。

如果无法访问实时数据源，MCP 工具会给出明确错误，而不会提供过时的内置数据。请稍后重试或查看状态。（自 v0.9.0 起，无法获取数据时会直接报错 — 早期版本内置的回退数据会偏离生产环境状态，因此已移除。）

集成示例

请参阅 pythia-oracle-examples，其中包含配置好 Hardhat 的 Solidity 合约，可直接部署到任意 Chainlink 支持的网络。

链接

• 网站与实时数据源浏览器
• 集成示例（Solidity + Hardhat）
• PyPI 软件包
• Telegram
• Twitter/X

许可证

MIT