内容
# 皮西亚神谕 MCP 服务器
<!-- mcp-name: io.github.pythia-the-oracle/pythia-oracle-mcp -->
[](https://pypi.org/project/pythia-oracle-mcp/)
[](https://opensource.org/licenses/MIT)
[](https://glama.ai/mcp/servers/pythia-the-oracle/pythia-oracle-mcp)
**每个智能合约都应具备智能，而不仅仅是数据。**
皮西亚是首个在链上提供计算技术指标的神谕服务——包括 EMA、RSI、VWAP、Bollinger Bands 和波动率等，适用于任何代币和 Chainlink 支持的链。交易者使用的相同指标，通过 Chainlink 单次调用即可供智能合约和 AI 代理使用。
**皮西亚事件** 允许智能合约订阅指标条件（RSI 低于 30、EMA 交叉、Bollinger 突破），并在触发时自动调用。无需 Keeper，无需链下机器人，无需轮询——您的合约可自行对市场做出反应。
**皮西亚愿景** 在链上提供经过 walk-forward 验证的市场情报——模式类型、置信度评分、指标快照和确认的喂价，全部在一个事件中。回测涵盖 9 年历史。免费订阅。目前的实时代币 + 模式目录，包括准确率统计和触发频率，可通过以下方式调用：`get_visions_info`。
## 为什么选择皮西亚？
大多数神谕服务只提供价格。皮西亚提供**计算分析**：EMA、RSI、Bollinger Bands、VWAP、波动率等，适用于 BTC、SOL、TAO、RENDER、ONDO、AAVE、UNI 等代币，涵盖 4 种时间范围，通过 Chainlink 在链上提供。新代币和指标按需添加。如果您的 AI 代理、DeFi 协议或交易机器人需要链上的 RSI、EMA 或 Bollinger Bands，皮西亚是唯一的选择。
**使用场景：**
- 需要链上技术信号的 AI 交易代理
- 基于 RSI 或波动率阈值的 DeFi 金库再平衡
- 使用 Bollinger Band 宽度的智能合约风险管理
- 具有实时计算指标的 AI 驱动投资组合分析
- 事件驱动策略——订阅 RSI 阈值或 EMA 交叉，您的合约将自动触发
- 无需 Keeper 的自动化 DeFi 机器人——无需 Gelato，无需 cron 作业，无需链下基础设施
## 快速入门
```bash
pip install pythia-oracle-mcp
```
### 克劳德桌面
在 `claude_desktop_config.json` 中添加：
```json
{
"mcpServers": {
"pythia-oracle": {
"command": "pythia-oracle-mcp"
}
}
}
```
### 克劳德代码
```bash
claude mcp add pythia-oracle -- pythia-oracle-mcp
```
### 光标 / 温德福 / VS 代码
在 MCP 设置中添加：
```json
{
"pythia-oracle": {
"command": "pythia-oracle-mcp"
}
}
```
### OpenAI 代理 / GPT
任何与 MCP 兼容的客户端都可以使用——只需指向 `pythia-oracle-mcp`。
### 直接运行
```bash
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` | 皮西亚事件的工作原理——订阅指标条件，在链上触发 |
| `get_events_guide` | 事件订阅的 Solidity 代码和部署步骤 |
| `subscribe_info` | 订阅详情——条件，定价，退款机制 |
| `get_visions_info` | 皮西亚愿景概览——walk-forward 验证的模式，触发频率，合约地址 |
| `get_visions_guide` | 订阅愿景和监听 VisionFired 事件的 Solidity 代码 |
| `get_vision_history` | 代币的近期愿景触发，模式分解和置信度统计 |
| `get_vision_payload` | 已触发愿景的完整丰富对象——失败配置文件，冷却上下文，并发触发 |
| `lookup_event_feed` | 反向查找事件 feedId（bytes32）到其人类可读的喂价名称 |
| `list_subscriptions` | 枚举所有者地址的活跃皮西亚事件订阅 |
| `get_feed_value` | 任何皮西亚指标喂价的最新计算值（链下缓存） |
## 示例提示
询问您的 AI 代理：
> “皮西亚有哪些比特币指标？”
调用 `get_token_feeds("bitcoin")` — 返回比特币的所有指标喂价，按类型分组。
> “皮西亚是否可靠到可以集成？”
调用 `check_oracle_health()` — 返回每个代币的正常运行时间，数据源健康状况和活跃事件。
> “给我一个 Solidity 合约来使用皮西亚的速度包。”
调用 `get_integration_guide("speed")` — 返回一个完整的，可部署的合约，包含正确的地址和作业 ID。
> “皮西亚涵盖哪些代币？它们是否都正常工作？”
调用 `get_market_summary()` — 返回生态系统覆盖范围，状态分解和基础设施健康状况。
> “皮西亚事件如何工作？我想在比特币 RSI 低于 30 时让我的合约做出反应。”
调用 `get_events_info()` — 返回订阅的工作原理，支持的条件和定价。
> “给我订阅 EMA 交叉事件的 Solidity 代码。”
调用 `get_events_guide()` — 返回一个可部署的 EventSubscriber 合约，包含订阅/接收模式。
> “什么是皮西亚愿景？它检测哪些模式？”
调用 `get_visions_info()` — 返回经过 walk-forward 验证的模式，准确率范围，触发频率，合约地址和工作原理。
> “给我最近的比特币愿景触发。”
调用 `get_vision_history("BTC")` — 返回最近的模式检测，置信度和价格。
> “给我订阅皮西亚愿景的 Solidity 代码。”
调用 `get_visions_guide()` — 返回一个订阅 VisionFired 事件的合约。
## 皮西亚提供的内容
- **任何代币，任何 Chainlink 支持的链** — 目前为 BTC、SOL、TAO、RENDER、ONDO、AAVE、UNI、MORPHO 等代币提供服务，按需添加新代币
- **6 种指标类型：** EMA、RSI、Bollinger Bands（上/下）、VWAP、波动率、美元价格
- **4 种时间范围：** 5 分钟、1 小时、1 天、1 周
- **4 种定价层级：** 发现/分析/速度/完整 — 当前的 LINK 费用，请调用 `get_pricing`
- **免费试用：** 皮西亚喷泉合约 — 无需 LINK
- **皮西亚事件：** 订阅指标条件（高于/低于阈值）— 当它们触发时，您的合约将被调用。预付 LINK，取消或触发时退款。无需 Keeper 基础设施。
- **皮西亚愿景：** 在链上提供经过 walk-forward 验证的市场情报 — 模式类型 + 置信度 + 指标快照 + 喂价确认，通过 Chainlink 交付。免费订阅。目前的模式 + 代币列表，请调用 `get_visions_info`。
## 数据新鲜度
此 MCP 服务器是 `https://pythia.c3x-solutions.com/feed-status.json` 的一个薄客户端，该实时状态馈送每 15 分钟由数据引擎更新。新代币、新模式、合约地址和定价变更在数据引擎周期的下一次更新后几秒内出现在 MCP 工具中 — 无需软件包更新。
如果实时馈送无法访问，MCP 工具会引发明确的错误，而不是提供过时的预烘焙数据。请稍后重试或检查状态。（从 v0.9.0 开始，大声失败 — 早期版本有预烘焙的后备程序，这些程序已经过时并且已被删除。）
## 集成示例
请参阅 [pythia-oracle-examples](https://github.com/pythia-the-oracle/pythia-oracle-examples) 以获取具有 Hardhat 设置的 Solidity 合约 — 随时可在任何 Chainlink 支持的网络上部署。
## 链接
- [网站和实时馈送资源管理器](https://pythia.c3x-solutions.com)
- [集成示例（Solidity + Hardhat）](https://github.com/pythia-the-oracle/pythia-oracle-examples)
- [PyPI 包](https://pypi.org/project/pythia-oracle-mcp/)
- [电报](https://t.me/pythia_the_oracle)
- [推特/X](https://x.com/pythia_oracle)
## 许可证
MIT
