概述

QuantDB MCP 是只读的数据查询入口：AI 客户端可在受控权限内发现数据集、检索标的、预览数据并查询短期日线。它不提供 COS 凭据、不创建下载直链、不执行交易；账户、订阅与第 6 类 ML 数据集权限仍由 QuantDB 主服务统一执行。

支持两种接入方式：

前置条件

• 一个 QuantDB 账户，并已创建 API Key。
• 本地 stdio 接入需要：Go 1.21+ 运行环境，以及本机已克隆 QuantDB 仓库。
• 远程接入无需本地环境，只需客户端支持远程 MCP（URL）与 OAuth 2.1。

创建 API Key

登录个人中心，在 API Key 区域创建一个仅供本机使用的密钥。请勿把 Key 提交到 Git 仓库、公开分享或粘贴到聊天内容。

把 API Key 直接填入下方配置的 QUANTDB_API_KEY 字段即可使用。也支持环境变量方式（客户端支持 ${env:...} 插值时）：

Windows 可用 setx QUANTDB_API_KEY "你的_API_Key" 持久化（重开终端生效）；macOS/Linux 写入 shell 配置或 export。

本地 stdio 配置

在客户端的 MCP 配置文件（或「MCP Servers」设置面板）中加入以下配置。将 cwd 替换为你本机 QuantDB 仓库的 backend 目录绝对路径。

{
  "mcpServers": {
    "quantdb": {
      "command": "go",
      "args": ["run", "./cmd/quantdb-mcp"],
      "cwd": "/path/to/quantDB/backend",
      "env": {
        "QUANTDB_API_BASE_URL": "https://quantdb.quantmind.cloud",
        "QUANTDB_API_KEY": "你的_API_Key"
      }
    }
  }
}

字段说明

在客户端中添加

环境变量为可选项：若已在系统中设置 QUANTDB_API_KEY，可将该字段改为 ${env:QUANTDB_API_KEY} 引用（部分客户端支持此插值），避免密钥落盘。

仓库内已提供示例配置 plugins/quantdb-mcp/.mcp.json，可直接参考或导入。

远程 MCP（OAuth 2.1）

远程 MCP 通过 HTTPS 暴露在 /api/v1/mcp，使用 OAuth 2.1 授权（支持动态客户端注册 DCR、PKCE S256 与 CIMD），无需本地 Go 环境。

{
  "mcpServers": {
    "quantdb": {
      "type": "http",
      "url": "https://quantdb.quantmind.cloud/api/v1/mcp"
    }
  }
}

客户端通常会自动发现 OAuth 配置（受保护资源元数据）：

状态说明：远程 MCP 服务端已在生产启用，正在客户端联测；授权流程为浏览器登录 → 同意授权 → 获得短期访问令牌，令牌可刷新、可撤销。如连接异常，请在个人中心或反馈渠道告知。

验证连接

1. 1
   确认服务已加载

   客户端连接后应能列出 quantdb 服务器及其工具。

2. 2
   让 AI 调用一次

   对 AI 说：用 QuantDB 搜索一下日线数据集，应触发 search_datasets 并返回数据集列表。

3. 3
   核对单位口径

   行情数据固定为：OHLC 为元、volume 为股、amount 为万元。

可用工具

常见问题