Aster Info Mcp

🚀 Aster Info MCP

Aster Info MCP 是一个 MCP 服务器，它提供对 Aster DEX 市场数据的结构化访问，涵盖K线图、订单簿、交易记录和资金费率等数据。

✨ 主要特性

• 13 种工具：可访问多种 Aster Finance Futures API 端点，包括：
  • K线数据（get_kline、get_index_price_kline、get_mark_price_kline）
  • 价格和行情数据（get_latest_price、get_price_change_statistics_24h、get_order_book_ticker）
  • 订单簿和交易数据（get_order_book、get_recent_trades、get_historical_trades、get_aggregated_trades）
  • 资金和指数数据（get_premium_index、get_funding_rate_history）
• Markdown 输出：所有工具返回的数据均为格式化的 Markdown 表格，便于阅读和集成。
• 强大的错误处理：能够处理 HTTP 错误（如 400、429）和数据处理问题，并抛出清晰的异常。

📦 安装指南

前提条件

• Python 3.10 或更高版本
• uv（推荐的包管理器）

步骤

1. 克隆仓库：

   git clone https://github.com/kukapay/aster-info-mcp.git
   cd aster-info-mcp
   

2. 安装依赖：

   uv sync
   

3. 安装到 Claude Desktop：

   将服务器作为 Claude Desktop 应用程序进行安装：

   uv run mcp install main.py --name "Aster Info"
   

   参考配置文件如下：

   {
   "mcpServers": {
   "Aster Info": {
   "command": "uv",
   "args": [ "--directory", "/path/to/aster-info-mcp", "run", "main.py" ]
   }
   }
   }
   

   请将 /path/to/aster-info-mcp 替换为你实际的安装路径。

💻 使用示例

可用工具

注意事项：

• 所有工具返回的数据均为 Markdown 表格。
• 标记为 (可选) 的参数为可选参数。
• 时间戳以毫秒为单位（Unix 时间戳）；输出会转换为易读的日期时间格式。
• 数字字段会四舍五入到 8 位小数（priceChangePercent 四舍五入到 2 位）。

基础用法

下面是 13 种工具的使用示例。

示例：获取 K 线数据（get_kline）

提示：

Get me the latest 1-minute candlestick data for ETHUSDT, limited to the last 2 entries.

预期响应（Markdown 表格）：

| open_time           | open      | high      | low       | close     |
|---------------------|-----------|-----------|-----------|-----------|
| 2025-06-18 22:42:00 | 3500.1234 | 3510.5678 | 3490.4321 | 3505.6789 |
| 2025-06-18 22:43:00 | 3505.6789 | 3520.1234 | 3500.8765 | 3510.2345 |

示例：获取指数价格 K 线数据（get_index_price_kline）

提示：

Show me the 1-hour index price candlestick data for BTCUSD for the last 2 hours.

预期响应（Markdown 表格）：

| open_time           | open       | high       | low        | close      |
|---------------------|------------|------------|------------|------------|
| 2025-06-18 21:00:00 | 65000.1234 | 65200.5678 | 64900.4321 | 65100.6789 |
| 2025-06-18 22:00:00 | 65100.6789 | 65300.1234 | 65050.8765 | 65210.2345 |

示例：获取标记价格 K 线数据（get_mark_price_kline）

提示：

Give me the 1-minute mark price candlestick data for BTCUSDT, limited to the last 2 entries.

预期响应（Markdown 表格）：

| open_time           | open       | high       | low        | close      |
|---------------------|------------|------------|------------|------------|
| 2025-06-18 22:42:00 | 65010.1234 | 65020.5678 | 65000.4321 | 65015.6789 |
| 2025-06-18 22:43:00 | 65015.6789 | 65030.1234 | 65010.8765 | 65025.2345 |

示例：获取溢价指数数据（get_premium_index）

提示：

Show me the premium index data for ETHUSDT.

预期响应（Markdown 表格）：

| symbol  | markPrice  | indexPrice | lastFundingRate | nextFundingTime     |
|---------|------------|------------|-----------------|---------------------|
| ETHUSDT | 3505.1234  | 3500.5678  | 0.0001          | 2025-06-19 00:00:00 |

示例：获取历史资金费率数据（get_funding_rate_history）

提示：

Get the funding rate history for BTCUSDT, limited to the last 2 records.

预期响应（Markdown 表格）：

| symbol  | fundingTime         | fundingRate |
|---------|---------------------|-------------|
| BTCUSDT | 2025-06-18 16:00:00 | 0.00012     |
| BTCUSDT | 2025-06-18 20:00:00 | 0.00015     |

示例：获取 24 小时价格变动统计数据（get_price_change_statistics_24h）

提示：

Show me the 24-hour price change statistics for ETHUSDT.

预期响应（Markdown 表格）：

| symbol  | priceChange | priceChangePercent | lastPrice  | volume     |
|---------|-------------|--------------------|------------|------------|
| ETHUSDT | 50.1234     | 1.45               | 3505.6789  | 1000.4321  |

示例：获取最新价格（get_latest_price）

提示：

Show me the current price of BTCUSDT.

预期响应（Markdown 表格）：

| symbol  | price      |
|---------|------------|
| BTCUSDT | 65000.1234 |

示例：获取订单簿行情数据（get_order_book_ticker）

提示：

Get the best bid and ask prices for ETHUSDT.

预期响应（Markdown 表格）：

| symbol  | bidPrice  | bidQty    | askPrice  | askQty    |
|---------|-----------|-----------|-----------|-----------|
| ETHUSDT | 3500.1234 | 10.5678   | 3505.6789 | 15.4321   |

示例：获取订单簿数据（get_order_book）

提示：

Show me the order book for BTCUSDT with 2 entries per side.

预期响应（Markdown 表格）：

| side | price      | quantity   |
|------|------------|------------|
| bid  | 65000.1234 | 0.5678     |
| bid  | 64995.6789 | 0.4321     |
| ask  | 65005.1234 | 0.8765     |
| ask  | 65010.6789 | 0.2345     |

示例：获取最近交易记录（get_recent_trades）

提示：

Get the most recent trades for ETHUSDT, limited to 2 trades.

预期响应（Markdown 表格）：

| tradeId | price     | qty       | quoteQty  | time                | isBuyerMaker |
|---------|-----------|-----------|-----------|---------------------|--------------|
| 123456  | 3505.6789 | 1.2345    | 4321.1234 | 2025-06-18 22:43:00 | True         |
| 123457  | 3500.1234 | 0.8765    | 3067.5678 | 2025-06-18 22:42:00 | False        |

示例：获取历史交易记录（get_historical_trades）

提示：

Show me historical trades for BTCUSDT starting from trade ID 1000, limited to 2 trades.

预期响应（Markdown 表格）：

| tradeId | price      | qty       | quoteQty   | time                | isBuyerMaker |
|---------|------------|-----------|------------|---------------------|--------------|
| 1000    | 65000.1234 | 0.1234    | 8025.6789  | 2025-06-18 20:00:00 | True         |
| 1001    | 64995.6789 | 0.2345    | 15245.1234 | 2025-06-18 20:01:00 | False        |

示例：获取聚合交易记录（get_aggregated_trades）

提示：

Get aggregated trades for ETHUSDT starting from aggregated trade ID 500, limited to 2 trades.

预期响应（Markdown 表格）：

| aggTradeId | price     | qty       | firstTradeId | lastTradeId | time                | isBuyerMaker |
|------------|-----------|-----------|--------------|-------------|---------------------|--------------|
| 500        | 3500.1234 | 5.6789    | 1000         | 1005        | 2025-06-18 22:40:00 | True         |
| 501        | 3505.6789 | 3.4321    | 1006         | 1010        | 2025-06-18 22:41:00 | False        |

📄 许可证

本项目采用 MIT 许可证 进行许可。