Aleatoric Engine MCP

🚀 Aleatoric MCP客戶端

Aleatoric MCP客戶端是Aleatoric Systems官方的MCP客戶端SDK，專為機構級合成市場數據生成而設計。它能為AI助手提供生成確定性合成市場數據的工具，用於回測、壓力測試和模型驗證，支持6家主流交易所，可跨交易所生成可重現的數據集。

🚀 快速開始

安裝方法

• 零安裝：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客戶端

根據不同的AI助手進行相應配置：

{
  "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"

✨ 主要特性

• 為AI助手提供生成確定性合成市場數據的工具，可用於回測、壓力測試和模型驗證。
• 支持Binance、HyperLiquid、OKX、Bybit、CME、SGX等6家主流交易所。
• 能夠生成可重現的數據集，確保測試的一致性和可重複性。

⚡ 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. 服務器生成 3600秒的數據（約14000個事件），具有真實的微觀結構。
3. 代理接收 簽名URL或數據流形式的數據。
4. 代理繪製 由 seed=123 定義的精確價格路徑。

結果：在不到2分鐘的時間內為你的回測生成一個完全可重現的市場場景。

📦 安裝指南

安裝方法

• 零安裝：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客戶端：根據不同的AI助手進行相應配置，具體配置方法見上文。
3. 驗證安裝：測試連接，確保安裝成功。
4. 開始使用：向你的AI助手提問，開始生成合成市場數據。

💻 使用示例

基礎用法

向AI助手提問：

"Validate this config: symbol BTC, seed 42, volatility 0.02"

高級用法

使用Python代碼直接調用API：

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']}")

更多完整示例見 examples/。

📚 詳細文檔

可用工具

提示與資源

• 提示：示例提問位於 README.md 中（見示例提示），可直接在支持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 確保腳本可解析。

🔧 技術細節

Aleatoric MCP客戶端通過與MCP服務器交互，為AI助手提供生成確定性合成市場數據的能力。服務器根據用戶提供的配置參數，生成具有真實微觀結構的市場數據，並通過簽名URL或數據流的形式返回給客戶端。客戶端可以使用這些數據進行回測、壓力測試和模型驗證等操作。

📄 許可證

本項目採用MIT許可證，詳情見 LICENSE。

支持信息

• 文檔：www.aleatoric.systems
• 問題反饋：GitHub Issues
• 郵箱：support@aleatoric.systems

定價

立即開始免費試用：www.aleatoric.systems