stock-mcp-query

Stock MCP Query 是一个通过 MCP 协议查询历史股票市场数据的技能，可获取日线 OHLCV、财务报告、指数数据、ETF 数据等。

用途

当用户需要检索历史每日行情等股票市场数据时使用该技能。数据来源为 ClickHouse，覆盖全部可用历史。

支持的数据类别

每日 K 线：OHLCV + 成交量 + 成交额，示例工具 tushare_daily_*
每日指标：PE、PB、市值、量比，示例工具 tushare_daily_basic_*
复权因子：前复权/后复权调整因子，示例工具 tushare_adj_factor_*
财务：资产负债表、利润表、现金流量表，如 tushare_balancesheet_* 等
指数：指数日线、权重、成份股，如 tushare_index_*
ETF：ETF 每日价格与持仓，如 tushare_fund_*
港股：港股每日数据，如 akshare_hk_*
市场：市场概览、交易日历，如 tushare_trade_cal_*

前置条件

STOCK_MCP_TOKEN 环境变量：从管理平台（nps_enhanced）购买的 JWT 令牌，必需。
STOCK_MCP_SERVER_URL 环境变量：MCP 服务器 URL，可选，默认使用购买时提供的 URL。

环境配置检查

在使用任何数据查询工具前，可先检查环境是否已配置：

# Check if token exists
echo ${STOCK_MCP_TOKEN:+Token is set}${STOCK_MCP_TOKEN:-ERROR: STOCK_MCP_TOKEN not set}

如果 STOCK_MCP_TOKEN 未设置：

访问管理平台（nps_enhanced web 面板）
进入 “MCP Data Query” 订阅页面
购买查询配额包（例如 10k 条记录 10 CNY）
复制签发的令牌
设置环境变量：

export STOCK_MCP_TOKEN="eyJ..."
export STOCK_MCP_SERVER_URL="https://your-node:8001/messages"

MCP 服务器配置

添加到 MCP 客户端配置：

{
  "mcpServers": {
    "stock-data": {
      "type": "streamable-http",
      "url": "${STOCK_MCP_SERVER_URL}",
      "headers": {
        "Authorization": "Bearer ${STOCK_MCP_TOKEN}"
      }
    }
  }
}

使用说明

每次工具调用返回数据并计入查询配额
响应中包含 _usage.record_count，显示返回的记录数
响应中包含 _usage.quota_remaining，显示剩余配额
配额耗尽时，从管理平台购买额外的包

计费

按每次工具调用返回的记录（数据行）计费
查询包自购买起 90 天有效
多个包可叠加（配额累加）
用量在 MCP 服务器与管理平台之间异步对账

故障排查

401 “API key required”：STOCK_MCP_TOKEN 未设置，或未在 Authorization 头中传递
401 “Token expired”：令牌已过期，需购买新的配额包以获取新令牌
401 “Invalid token”：令牌格式错误，或服务器公钥不匹配
无数据返回：检查请求日期是否为交易日，或股票代码是否有效
配额耗尽：_usage.quota_remaining 显示为 0，需购买额外包

技能介绍

用途

支持的数据类别

前置条件

环境配置检查

MCP 服务器配置

使用说明

计费

故障排查