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 startClaude桌面配置
添加到您的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许可证-请参阅 许可证 了解详情。
______________________________________________________________________
