Datawhy MCP 接入指南

Datawhy（小智问数）提供标准 MCP（Model Context Protocol）服务器，把 A 股行情问数能力以工具形式开放给支持 MCP 协议的客户端（Kimi、Claude、Cursor 等）。接入后，用户在客户端里用自然语言提问，客户端经 MCP 工具调用 Datawhy 行情数据接口返回结构化结果。

三个标准工具

工具	能力	关键参数
query_daily	指数 / ETF / 个股日线行情：开高低收、涨跌幅、成交量额、换手率	symbol（如 000001.SH）、start_date、end_date、limit（1-500）
query_snapshot	最新行情快照：最新价、昨收、涨跌幅、当日高低、量额；快照缺失自动回退最近收盘	symbols（1-10 个代码）
get_calendar	交易日历：逐日交易/休市、节假日、半日市、前后交易日	start_date、end_date、exchange（SSE/SZSE/BSE）

代码一律带交易所后缀：000001.SH 上证指数、399006.SZ 创业板指、510300.SH 沪深300ETF、600519.SH 贵州茅台。

客户端接入配置（二选一）

方式一：远程直连（推荐·免安装）

Streamable HTTP 端点，任何支持远程 MCP 的客户端（Claude、Kimi、扣子及各 Agent 平台）直接配置：

端点：https://datawhy.cn/mcp-server/mcp
请求头：X-API-Key: 你的密钥（datawhy.cn 个人中心创建）

以 JSON 配置形态（claude_desktop_config.json / 客户端 MCP 设置）：

{
  "mcpServers": {
    "datawhy": {
      "type": "http",
      "url": "https://datawhy.cn/mcp-server/mcp",
      "headers": { "X-API-Key": "你的密钥" }
    }
  }
}

方式二：本地 stdio（进阶）

{
  "mcpServers": {
    "datawhy": {
      "command": "node",
      "args": ["/安装路径/mcp-datawhy/server.js"],
      "env": { "DATAWHY_API_KEY": "你的密钥" }
    }
  }
}

亦可用任意 HTTP 客户端直连端点（JSON-RPC 2.0·POST）。额度与限速按密钥账户口径（datawhy.cn 个人中心可查用量）。

额度

免费档每日 10 次查询；付费档额度与计费以 datawhy.cn 现架上套餐为准。

环境要求

Node.js ≥ 18；Python 3 与 pymysql（数据层）；可访问 Datawhy 行情数据接口。

获取接入包

MCP server 包与接入文档目前处于内测阶段，可通过 datawhy.cn（小智问数）获取最新版本与接入支持。

更多接入方式：API 数据产品接入（agent-access）——公网 HTTPS API＋datawhy_info skill 包（ZCode / Claude Code / Codex 通装）。

datawhy.cn 首页｜ API / Agent 接入｜治数时光（内容社区）