drephantom/wq-brain-mcp-server

Local MCP server for WorldQuant BRAIN research — 8 tools with explicit safety boundaries

About wq-brain-mcp-server

本地 WorldQuant BRAIN 研究工具的 MCP Server 与配套 CLI——把平台能力封装成 LLM Agent 可安全调用的 8 个工具，并用多层闸门保证"Agent 可以跑研究，但不能自己提交"。

公开脱敏说明： 本仓库是量化研究 Agent 的公开脱敏版本，仅包含 MCP 工具、确定性执行器与提交安全边界；不包含账号凭据、Alpha 表达式、候选/模拟结果、跨日 Campaign State、回归用例或完整私有 Agent Harness。

TL;DR (English): A dependency-free MCP server (stdio JSON-RPC) exposing 8 tools for WorldQuant BRAIN research — account status, platform settings, dataset/field/operator discovery, recent alphas, candidate writing, and a guarded multi-simulation runner. Alpha submission is deliberately not exposed at the MCP layer; submissions go through a separate CLI with day/quota/cost/stability gates.

在 Agent 驱动的量化研究工作流里，平台没有官方 MCP 支持，Agent 无法直接检索数据字段、批量提交模拟。直接给 Agent 浏览器或裸 API 又不可接受：模拟消耗平台配额，提交影响真实账户。这个项目把两者分开：

- MCP 层只做研究与验证：检索、候选写入、批量模拟全部可由 Agent 自主调用； - 提交彻底移出 MCP 层：服务器代码中不存在 submit 工具，提交走独立的 CLI，且必须通过交易日、日额度、交易成本、PnL 稳定性等多重人工确认闸门。

工具 作用 安全约束 --------- wqauthstatus 认证并返回脱敏账户摘要 仅返回白名单字段 wqgetplatformsettingoptions 读取平台模拟设置选项 只读 wqlistdatasets 按区域/宇宙/延迟列出数据集 分页上限 100 wqsearchdatafields 检索数据字段（数据集/类别/类型/文本） 分页上限 50，短超时防阻塞 wqgetoperators 列出算子（可按类别/关键词过滤） 分页上限 500 wqrecentalphas 读取最近 Alpha 列表与详情 只读 wqwritecandidates 将候选写入工作区 JSONL 路径限制在工作区内 wqrunmultisimfile 批量多模拟 必须显式 confirmrun=true；批量 2–10；并发 1–8；大批量需 background=true 或显式放行

1. 不暴露提交工具——TOOLS 注册表中不存在 submit，服务器 instructions 明确声明； 2. 显式确认才能消耗配额——wqrunmultisimfile 缺少 confirmrun=true 直接抛错； 3. 路径逃逸防护——所有输入/输出路径经 safeworkspacepath 校验，禁止越出工作区； 4. 防 UI 阻塞——大批量任务强制后台运行或双重显式确认； 5. 平台礼貌性——全链路尊重 Retry-After，429/502/503/504 有界重试，401 自动重认证。

From the project README.

Maintaining this server?

Add the radar badge to your README — it shows your project was picked up by MCP Radar and links to this page:

[![On MCP Radar](https://mcp.liqiwa.com/badge.svg)](https://mcp.liqiwa.com/s/drephantom--wq-brain-mcp-server.html)

Related MCP servers