Aster Info MCP

🚀 Aster Info MCP

Aster Info MCPは、Aster DEXの市場データ（ローソク足、板情報、取引、資金レートなど）に構造化されたアクセスを提供するMCPサーバーです。

✨ 主な機能

• 13のツール：Aster Finance Futures APIのさまざまなエンドポイントにアクセスできます。以下のようなものが含まれます。
  • ローソク足データ (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のツールそれぞれの使用例です。

例：ローソク足データの取得 (get_kline)

プロンプト：

ETHUSDTの最新の1分足ローソク足データを最後の2件まで取得してください。

期待される応答（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 |

例：指数価格のローソク足データの取得 (get_index_price_kline)

プロンプト：

BTCUSDの過去2時間の1時間足指数価格のローソク足データを表示してください。

期待される応答（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 |

例：マーク価格のローソク足データの取得 (get_mark_price_kline)

プロンプト：

BTCUSDTの1分足マーク価格のローソク足データを最後の2件まで取得してください。

期待される応答（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)

プロンプト：

ETHUSDTのプレミアム指数データを表示してください。

期待される応答（Markdownテーブル）：

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

例：資金レート履歴の取得 (get_funding_rate_history)

プロンプト：

BTCUSDTの資金レート履歴を最後の2件まで取得してください。

期待される応答（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)

プロンプト：

ETHUSDTの24時間の価格変動統計を表示してください。

期待される応答（Markdownテーブル）：

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

例：最新価格の取得 (get_latest_price)

プロンプト：

BTCUSDTの現在の価格を表示してください。

期待される応答（Markdownテーブル）：

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

例：板情報のティッカーデータの取得 (get_order_book_ticker)

プロンプト：

ETHUSDTの最良の買い注文価格と売り注文価格を取得してください。

期待される応答（Markdownテーブル）：

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

例：板情報の取得 (get_order_book)

プロンプト：

BTCUSDTの板情報を片側2件まで表示してください。

期待される応答（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)

プロンプト：

ETHUSDTの最新の取引を2件まで取得してください。

期待される応答（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)

プロンプト：

BTCUSDTの取引ID 1000から始まる過去の取引を2件まで表示してください。

期待される応答（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)

プロンプト：

ETHUSDTの集計取引ID 500から始まる集計取引を2件まで取得してください。

期待される応答（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ライセンス の下でライセンスされています。