使用说明
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
快速开始
# 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):
{
"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 |
记录冗长 |
发展
# Install dependencies
pnpm install
# Run in development mode
pnpm dev
# Run tests
pnpm test
# Build for production
pnpm build
# Lint
pnpm lint
许可证
MIT许可证-请参阅 许可证 了解详情。
