Pyth网络MCP服务器
Pyth Network oracle数据的官方模型上下文协议（MCP）服务器。
企业级TypeScript实现，为Claude和其他AI系统提供对Pyth Network去中心化oracle基础设施的直接访问。
概述
此MCP服务器使AI代理能够通过标准化协议与Pyth Network的实时价格馈送、历史数据和网络信息进行交互。专为生产使用而设计，具有全面的错误处理、类型安全和性能优化功能。
什么是Python网络？
Pyth Network是一个去中心化的oracle协议，为107多个区块链的智能合约提供实时市场数据。在125多家第一方数据提供商（交易所、做市商、交易公司）的支持下，Pyth提供：
- 1930+价格信息 涵盖加密货币、股票、外汇、大宗商品和利率
- ~400ms更新频率 具有亚秒级延迟
- 通用价格馈送ID 适用于所有受支持的链
- 置信区间 适用于具有风险意识的应用程序
特性
工具
| 工具 | 说明 |
|---|---|
get_price_feeds |
按交易品种、资产类型或查询搜索和过滤1930+个价格提要 |
get_latest_price |
获取具有置信区间和发布时间的实时价格 |
get_price_at_timestamp |
查询特定Unix时间戳的历史价格 |
get_twap |
计算时间加权平均价格（1-600秒窗口） |
get_publisher_caps |
访问发布者质押限制和网络健康数据 |
get_price_feed_info |
特定价格提要的详细元数据 |
stream_price_updates |
通过SSE订阅实时价格流 |
get_benchmark_history |
按时间间隔查询历史价格数据 |
资源
| 资源URI | 描述 |
|---|---|
pyth://network/status |
网络健康、支持链和统计数据 |
pyth://feeds/catalog |
可用价格提要的完整目录 |
pyth://feeds/popular |
常用的订阅源（BTC、ETH、SOL、主要货币对） |
pyth://docs/api |
爱马仕API端点快速参考 |
pyth://docs/integration |
集成指南和最佳实践 |
提示
| 提示 | 描述 |
|---|---|
analyze_price_feed |
对具有价格、TWAP和波动性的资产进行深入分析 |
compare_assets |
多个价格提要的并排比较 |
market_overview |
资产类别的综合报告 |
arbitrage_scanner |
跨交易所价差分析 |
volatility_report |
历史波动性指标和风险评估 |
安装
先决条件
- Node.js 18+
- npm或pnpm
快速开始```bash
Clone and install
git clone https://github.com/pyth-network/mcp-server.git
cd mcp-server
pnpm install
Build
pnpm build
Run
pnpm start
### Claude桌面配置
添加到您的Claude桌面配置(`~/.config/claude/claude_desktop_config.json`):```json
{
"mcpServers": {
"pyth-network": {
"command": "node",
"args": ["/path/to/pyth-mcp-server/dist/index.js"],
"env": {
"PYTH_HERMES_URL": "https://hermes.pyth.network"
}
}
}
}
建筑```
pyth-mcp-server/
├── src/
│ ├── index.ts # Server entry point
│ ├── server.ts # MCP server implementation
│ ├── api/
│ │ ├── hermes.ts # Hermes API client
│ │ ├── benchmarks.ts # Benchmarks API client
│ │ └── types.ts # API response types
│ ├── tools/
│ │ ├── index.ts # Tool registry
│ │ ├── price-feeds.ts # Price feed tools
│ │ ├── historical.ts # Historical data tools
│ │ └── network.ts # Network info tools
│ ├── resources/
│ │ ├── index.ts # Resource registry
│ │ └── handlers.ts # Resource handlers
│ ├── prompts/
│ │ ├── index.ts # Prompt registry
│ │ └── templates.ts # Prompt templates
│ └── types/
│ ├── mcp.ts # MCP protocol types
│ └── pyth.ts # Pyth-specific types
├── tests/
├── docs/
└── dist/
______________________________________________________________________
## api参考
### 爱马仕API（实时数据）
基本URL: `https://hermes.pyth.network`
|终点|目的|
|----------|---------|
| `/v2/price_feeds` |列出所有可用的价格提要|
| `/v2/updates/price/latest` |获取订阅源ID的最新价格|
| `/v2/updates/price/{timestamp}` |获取特定时间戳的价格|
| `/v2/updates/twap/latest` |获取饲料ID的TWAP|
| `/v2/updates/publisher_stake_caps/latest` |出版商质押数据|
### 基准API（历史数据）
基本URL: `https://benchmarks.pyth.network`
|终点|目的|
|----------|---------|
| `/v1/price_feeds/` |带元数据的标价提要|
| `/v1/updates/price/{timestamp}` |时间戳的历史价格|
| `/v1/updates/price/{timestamp}/{interval}` |带时间间隔的价格历史|
| `/v1/shims/tradingview/history` |兼容TradingView的OHLCV|
______________________________________________________________________
## 与社区版本的差异
与社区构建的版本相比，此官方实现提供了几个优势：
|特色|社区|官方|
|---------|-----------|----------|
|语言| Python | TypeScript|
|类型安全|运行时|编译时|
|流媒体|否|SSE支持|
|历史数据|基础|全面基准API|
|错误处理|基本|全面重试|
|缓存|无|智能缓存|
|速率限制|无|根据限制构建|
|文档|良好|广泛|
|维护|社区| Python基金会|
______________________________________________________________________
## 环境变量
|变量|默认值|描述|
|----------|---------|-------------|
| `PYTH_HERMES_URL` | `https://hermes.pyth.network` |爱马仕API终点|
| `PYTH_BENCHMARKS_URL` | `https://benchmarks.pyth.network` |基准API终点|
| `PYTH_CACHE_TTL` | `5000` |缓存TTL（毫秒）|
| `PYTH_REQUEST_TIMEOUT` | `30000` |请求超时（毫秒）|
| `LOG_LEVEL` | `info` |记录冗长|
______________________________________________________________________
## 发展```bash
# Install dependencies
pnpm install
# Run in development mode
pnpm dev
# Run tests
pnpm test
# Build for production
pnpm build
# Lint
pnpm lint
许可证
MIT许可证-请参阅 许可证 了解详情。
链接
- Pyth网络
- Pyth文档
- 爱马仕 API
- API基准
- MCP规范
