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