Aleatoric Engine MCP

🚀 Aleatoric MCP Client

Aleatoric MCP Clientは、Aleatoric Systemsによる公式MCPクライアントSDKです。機関投資家向けの合成市場データ生成機能を提供し、バックテストやストレステスト、モデル検証に役立ちます。

🚀 クイックスタート

インストール方法

• ゼロインストール：MCPサーバはホスト型で、ローカルバイナリのビルドや実行は不要です。
• 即座に使える設定ファイル：configs/にClaude Desktop、Cursor、VS Code Copilot、Cline用のJSON設定ファイルが用意されています。YOUR_API_KEY_HEREをあなたのAPIキーに置き換えてください。
• 公開ディスカバリ：healthとmanifestのエンドポイントは公開されており、LobeHubなどのレジストリとの統合が容易です。

# 公開ヘルスチェック (APIキー不要)
curl -s https://mcp.aleatoric.systems/mcp/health

1. APIキーの取得

www.aleatoric.systemsでサインアップし、APIキーを取得してください。

2. MCPクライアントの設定

以下のようにMCPクライアントの設定を追加してください。

{
  "mcpServers": {
    "aleatoric": {
      "url": "https://mcp.aleatoric.systems/mcp",
      "headers": {
        "X-API-Key": "your-api-key-here"
      }
    }
  }
}

{
  "mcpServers": {
    "aleatoric": {
      "url": "https://mcp.aleatoric.systems/mcp",
      "headers": {
        "X-API-Key": "your-api-key-here"
      }
    }
  }
}

{
  "servers": {
    "aleatoric": {
      "type": "http",
      "url": "https://mcp.aleatoric.systems/mcp",
      "headers": {
        "X-API-Key": "your-api-key-here"
      }
    }
  }
}

{
  "aleatoric": {
    "url": "https://mcp.aleatoric.systems/mcp",
    "headers": {
      "X-API-Key": "your-api-key-here"
    }
  }
}

{
  "name": "Aleatoric Engine",
  "identifier": "aleatoric-engine-mcp",
  "manifest": "https://mcp.aleatoric.systems/mcp/manifest",
  "type": "remote",
  "url": "https://mcp.aleatoric.systems/mcp",
  "headers": {
    "X-API-Key": "YOUR_API_KEY_HERE"
  }
}

3. インストールの確認

接続をテストします（このエンドポイントはディスカバリ用に公開されています）。

curl -s https://mcp.aleatoric.systems/mcp/health

期待される出力:

{"status": "ok", "version": "0.4.4"}

4. 使用の開始

AIアシスタントに以下のように問いかけます。

"Generate 1 hour of BTC synthetic order book data with seed 42"

✨ 主な機能

Aleatoric MCPは、AIアシスタントに決定論的な合成市場データを生成するツールを提供します。6つの主要取引所にまたがる再現可能なデータセットを生成できます。

対応取引所: Binance、HyperLiquid、OKX、Bybit、CME、SGX

⚡ 90秒デモ

AIアシスタント（Cursor、Claude、Windsurf）でこれを実行します。

"Generate a 1-hour dataset of BTC/USDT L2 order book updates on Binance. Use seed 123 for reproducibility. Plot the mid-price and spread over time."

起こること:

1. エージェントが validate_config を呼び出してパラメータを固定します。
2. サーバが 3,600秒のデータ（約14,000イベント）を現実的なマイクロ構造で生成します。
3. エージェントが 署名付きのURLまたはデータのストリームを受け取ります。
4. エージェントが seed=123 で定義された正確な価格パスをプロットします。

結果: 2分以内でバックテスト用の完全に再現可能な市場シナリオが得られます。

利用シーン

• バックテスト：数ヶ月分の現実的なオーダーブックデータを数秒で生成します。
• ストレステスト：再現可能なシードを使用して極端な市場条件をシミュレートします。
• モデル検証：決定論的な合成データに対してトレードアルゴリズムをテストします。
• CI/CDパイプライン：一貫した市場シナリオで自動テストを行います。
• 研究：複数の取引所での資金レートのダイナミクスを調査します。

決定論的データの必要性

ランダムなデータはエンジニアリングには役に立ちません。以下が必要です。

1. 再現性：テストが失敗した場合、まったく同じ市場条件を再現してデバッグできる必要があります。
2. 制御：特定の異常（フラッシュクラッシュ、流動性の欠如）を注入して、実運用で数年間起こらない可能性のあるエッジケースをテストします。
3. コンプライアンス：資金を投入する前に、アルゴリズムが既知の不利なシナリオを処理できることを証明します。
4. 速度：高価なサブスクリプションやレート制限なしで、数分で10年分のティックデータを生成します。

💻 使用例

基本的な使用法

import httpx
import os

api_key = os.getenv("ALEATORIC_API_KEY")
base_url = "https://mcp.aleatoric.systems"

with httpx.Client(timeout=30) as client:
    # Get available presets
    response = client.get(
        f"{base_url}/mcp/presets",
        headers={"X-API-Key": api_key}
    )
    presets = response.json()

    # Validate a configuration
    config = {
        "symbol": "BTC",
        "seed": 42,
        "tick_size": 0.01,
        "lot_size": 0.001,
        "initial_mid": 50000.0,
        "volatility": 0.02,
    }
    response = client.post(
        f"{base_url}/mcp/config/validate",
        json={"config": config},
        headers={"X-API-Key": api_key}
    )
    result = response.json()
    print(f"Valid: {result['valid']}, Hash: {result['hash']}")

高度な使用法

# 例えば、特定の取引所での資金シミュレーションを行う場合
python examples/funding_simulation.py --exchange hyperliquid

📚 ドキュメント

利用可能なツール

プロンプトとリソース

• プロンプト：README.mdにある例の問い合わせ（Example Prompts）をそのままMCP対応のIDEで再利用できます。
• リソース：サーバはMCP resources を公開しており、キャッシュの検査やエクスポートに使用できます。get_cache_stats、stream_cache、またはexport_cache を使用して出力を取得し、下流のツールに供給できます。

🔧 技術詳細

検証チェックリスト（エンドツーエンド）

• ヘルスチェック：curl -s -H "X-API-Key: $ALEATORIC_API_KEY" https://mcp.aleatoric.systems/mcp/health → { "status": "healthy", "version": "0.4.3" } が期待されます。
• マニフェスト：python examples/list_presets.py --manifest → サーバ名/バージョンとツールリストが表示されます。
• ツール呼び出し：python examples/validate_config.py --symbol BTC --seed 42 → 正規化された設定で Valid! Hash: ... が期待されます。
• リソースフロー：python examples/funding_simulation.py --exchange hyperliquid → ツールとリソースの出力をテストします。キャッシュエンドポイントの場合は、get_cache_stats を呼び出してから stream_cache/export_cache を呼び出します（MCPクライアントでリソースを添付します）。
• オフライン健全性チェック（ネットワークなし）：依存関係をインストールした後、python -m compileall examples を実行してスクリプトが解析されることを確認します。

📄 ライセンス

このプロジェクトはMITライセンスの下でライセンスされています。詳細は LICENSE を参照してください。

サポート

• ドキュメント: www.aleatoric.systems
• 問題報告: GitHub Issues
• メール: support@aleatoric.systems

価格

無料トライアルを開始するには、www.aleatoric.systems を訪問してください。