Aleatoric Engine MCP

Aleatoric MCP客户端

官方MCP客户端SDK 警报系统 --机构级合成市场数据生成。

已验证合规性： 该客户端完全符合Aleatoric Engine API v0.5.10和MCP协议版本2024-11-05（JSON-RPC 2.0）。所有示例都针对实时生产端点进行了测试。

关键词： mcp market-data synthetic-data backtesting trading fintech quantitative-finance perpetuals futures order-book

概述

Aleatoric MCP为AI助手提供了生成确定性合成市场数据的工具，用于回溯测试、压力测试和模型验证。连接您的AI编码助手，在6个主要交易所生成可重复的数据集。

查看我们的 路线图 用于计划中的功能和架构更新。

支持的交易所： 币安、HyperLiquid、OKX、Bybit、CME、SGX

⚡ 90秒演示

在您的AI助手（Cursor、Claude、Windsurf）中运行以下命令：

“在币安上生成BTC/USDT L2订单簿更新的1小时数据集。使用种子123进行可重复性。绘制中间价格和随时间的价差。”

发生了什么：

1. 客服电话 generate_dataset 请求数据。
2. 服务器生成 3600个数据（约14000个事件），具有逼真的微观结构。
3. 代理人收到 已签名的下载URL。
4. 特工阴谋 由下式定义的确切价格路径 seed=123.

*结果：在2分钟内为您的回溯测试提供一个完全可重复的市场场景。*

公开验证展示

在没有任何本地服务器的情况下，对托管的MCP运行确定性哈希检查和可选的Parquet导出：

cd public/aleatoric-engine-mcp
pip install -r examples/requirements.txt
export ALEATORIC_API_KEY="your-api-key"
python examples/validation_showcase.py --symbol BTC --seed 42 --duration 60

如果您有缓存密钥，请添加 --cache-key 下载拼花工艺品。

用例

• 回溯测试 --在几秒钟内生成几个月的实际订单数据
• 压力测试 --用可再生种子模拟极端市场条件
• 模型验证 --根据确定性合成数据测试交易算法
• CI/CD管道 --具有一致市场场景的自动化测试
• 研究 --探索各场馆的资金率动态

为什么是确定性数据？

随机数据对工程毫无用处。你需要：

1. 再现性： 如果测试失败，您必须能够重播 *精确* 在相同的市场条件下进行调试。
2. 控制： 注入特定的异常（闪崩、流动性空洞）来测试在生产中可能多年都不会发生的边缘情况。
3. 顺从： 在部署资金之前，证明你的算法能够处理已知的不利情况。
4. 速度： 在几分钟内生成10年的分时数据，无需昂贵的订阅或费率限制。

快速开始

安装方法（友好）

• 零安装 --托管MCP服务器；没有本地二进制文件可供构建或运行。
• 插入配置 --准备好JSON configs/ 适用于Claude Desktop、Cursor、VS Code Copilot和Cline；替换 YOUR_API_KEY_HERE 用你的钥匙。
• 公开发现 --端点 health 和 manifest 可公开访问，以便与LobeHub等注册表轻松集成。

# Public health check (No API Key required)
curl -s https://mcp.aleatoric.systems/mcp/health

本地桥（检查员和克劳德桌面）

与官方一起使用 MCP检查员 或通过stdio访问克劳德桌面：

1. 设置API密钥：

   export ALEATORIC_API_KEY="your-key"

1. 运行网桥服务器：

   npx @modelcontextprotocol/inspector python server.py

示例

• 看 examples/README.md 对于精心策划的流程：

- 列出预设值： python examples/list_presets.py --manifest - 验证配置（哈希）： python examples/validate_config.py --symbol BTC --seed 42 - 资金模拟： python examples/funding_simulation.py --exchange binance - 验证展示（哈希+可选导出）： python examples/validation_showcase.py --symbol BTC --seed 42 --duration 60

1.获取API密钥

在以下网址创建您的帐户 data.aleatoric.systems/get-started. 相同的注册帐户和发布API关键工作 data.aleatoric.systems, sim.aleatoric.systems，以及 mcp.aleatoric.systems. 公共发现端点保持开放，但经过身份验证的MCP/数据路由需要 先注册。

2.配置您的MCP客户端

添加到MCP客户端配置中：

Claude Desktop

编辑 ~/Library/Application Support/Claude/claude_desktop_config.json （macOS）或 %APPDATA%\Claude\claude_desktop_config.json （Windows）：

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

Cursor

编辑 .cursor/mcp.json 在您的项目或 ~/.cursor/mcp.json 全球地：

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

VS Code (Copilot)

编辑 .vscode/mcp.json:

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

Cline

通过Cline MCP设置添加：

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

LobeHub (One-Click)

1. 首选 设置→ 代理→ 插件设置.
2. 点击 “通过JSON添加” 并粘贴：

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

4.开始使用

问你的AI助手：

“使用种子42生成1小时的BTC合成订单数据”

可用工具

提示和资源

• 提示： 示例询问住在 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": "ok", "version": "0.5.10", "timestamp": "..." }.
• 显示： 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 examples/validation_showcase.py --symbol BTC --seed 42 --duration 60 确认确定性哈希值，并可选择导出缓存的Parquet。
• 离线健全性（无网络）： python -m compileall examples 安装deps后，确保脚本解析。

示例提示

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

"List available presets for perpetual futures"

"Simulate 10 days of funding rates on HyperLiquid with spot=50000 and mark=50100"

"What exchanges does Aleatoric support?"

"Export my cached dataset as Parquet"

API直接使用

对于没有MCP客户端的程序化访问：

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

看 示例/ 查看更完整的示例。

MCP JSON-RPC 2.0协议

与Aleatoric互动的推荐方式。标准MCP协议 POST /mcp.

协议细节

• 版本: 2024-11-05
• 运输：使用JSON-RPC 2.0的HTTP POST
• 认证: X-API-Key 头球

方法

示例：工具/调用

curl -X POST https://mcp.aleatoric.systems/mcp \
  -H "X-API-Key: $ALEATORIC_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "validate_config",
      "arguments": {
        "config": {"symbol": "BTC", "seed": 42}
      }
    }
  }'

响应格式

所有工具结果均遵循MCP内容格式：

{
  "jsonrpc": "2.0",
  "id": 1,
  "result": {
    "content": [{"type": "text", "text": "{\"valid\": true, \"hash\": \"sha256:...\"}"}],
    "isError": false
  },
  "error": null
}

API 参考

API完整文档： www.aleatoric.systems

主要端点（MCP JSON-RPC）

发现端点（公共，无身份验证）

传统HTTP端点

定价

开始免费试用： www.aleatoric.systems

支持

• 文档： www.aleatoric.systems
• 问题：
• 电子邮件：support@aleatoric.systems

许可证

Apache许可证2.0-请参阅 许可证

______________________________________________________________________

©2024-2026 Aleatoric Systems。保留所有权利。