跳到主要内容

MCP 工具概览

MCP 工具是给 LLM Agent 用的 REST 适配器。它不重写业务逻辑，只重新组织参数与 响应形态，让 LLM 在对话中更容易选对工具、传对参数、解析返回值。

  • 薄包装原则：工具实现层只调 REST router，不直接访问 service 层。
  • 数据语义一致：MCP 与 REST 共享同一套后端 capability，字段含义完全相同。
  • 错误透传：REST 错误体 {code, message, request_id} 原样回传给客户端。

鉴权​

形态入口鉴权
托管 MCP Server上游网关代理网关校验 X-api-key header
自托管 / 本地调试通过 MCP 客户端本地启动环境变量 API_KEY 注入
export API_KEY="<your-api-key>"

API Key 与 REST API 共用，可在 API Key 管理 页签发。

MCP 服务与访问端点​

按标的宇宙拆分为三个 MCP 服务，MCP 端点 host 为 fuyao.aicubes.cn：

MCP 服务标的宇宙MCP 访问端点
fuyao-a-share-mcpA 股标的宇宙https://fuyao.aicubes.cn/mcp/a-share
fuyao-a-share-index-mcpA 股同花顺指数https://fuyao.aicubes.cn/mcp/a-share-index
fuyao-meta-mcp跨宇宙元信息https://fuyao.aicubes.cn/mcp/meta

fuyao-meta-mcp 提供的标的检索是其余业务工具的前置步骤，建议与任一业务 MCP 服务 一起加载。挂载到 Claude Desktop / Cursor / 其他 MCP 客户端后即可在对话中调用以下 工具。

客户端快速配置​

把下面这段 JSON 粘进 MCP 客户端的配置文件即可同时挂载两个服务。<your-api-key> 替换为在 API Key 管理 页签发的 API Key。

{
  "mcpServers": {
    "fuyao-a-share": {
      "type": "http",
      "url": "https://fuyao.aicubes.cn/mcp/a-share",
      "headers": {
        "X-api-key": "<your-api-key>"
      }
    },
    "fuyao-a-share-index": {
      "type": "http",
      "url": "https://fuyao.aicubes.cn/mcp/a-share-index",
      "headers": {
        "X-api-key": "<your-api-key>"
      }
    },
    "fuyao-meta": {
      "type": "http",
      "url": "https://fuyao.aicubes.cn/mcp/meta",
      "headers": {
        "X-api-key": "<your-api-key>"
      }
    }
  }
}

各客户端配置文件位置：

客户端配置文件路径
Claude Desktop~/Library/Application Support/Claude/claude_desktop_config.json (macOS) · %APPDATA%\Claude\claude_desktop_config.json (Windows)
Cursor~/.cursor/mcp.json
Windsurf~/.codeium/windsurf/mcp_config.json
Cline (VS Code)命令面板 → Cline: Open MCP Settings

配好后重启客户端生效，在对话里可直接调用下表中的工具。

工具一览​

当前共注册 11 个工具，覆盖行情快照、历史 K 线、复权因子事件流、财务报表（利润表 / 资产负债表 / 现金流量表）、交易日历、标的检索 / 目录、同花顺指数列表 / 成分股。

MCP 服务MCP 端点MCP 工具中文名对应 REST
fuyao-a-share-mcp/mcp/a-shareget_a_share_prices_snapshotA股行情快照GET /api/a-share/prices/snapshot
fuyao-a-share-mcp/mcp/a-shareget_a_share_prices_historicalA股历史K线GET /api/a-share/prices/historical
fuyao-a-share-mcp/mcp/a-shareget_a_share_corporate_actions_adjustment_factors复权因子事件流GET /api/a-share/corporate-actions/adjustment-factors
fuyao-a-share-mcp/mcp/a-shareget_a_share_financials_income_statements利润表GET /api/a-share/financials/income-statements
fuyao-a-share-mcp/mcp/a-shareget_a_share_financials_balance_sheets资产负债表GET /api/a-share/financials/balance-sheets
fuyao-a-share-mcp/mcp/a-shareget_a_share_financials_cash_flow_statements现金流量表GET /api/a-share/financials/cash-flow-statements
fuyao-a-share-mcp/mcp/a-shareget_a_share_calendar_trading_daysA股交易日历GET /api/a-share/calendar/trading-days
fuyao-a-share-index-mcp/mcp/a-share-indexget_a_share_index_catalog_ths_index_list同花顺指数列表GET /api/a-share-index/catalog/ths-index-list
fuyao-a-share-index-mcp/mcp/a-share-indexget_a_share_index_constituents_ths_stock_list同花顺指数成分股GET /api/a-share-index/constituents/ths-stock-list
fuyao-meta-mcp/mcp/metaget_meta_tickers_search标的检索（跨市场消歧）GET /api/meta/tickers/search
fuyao-meta-mcp/mcp/metaget_meta_tickers_list标的目录（代码表浏览）GET /api/meta/tickers/list

AI Agent 跨服务调用场景​

get_meta_tickers_search 是前置工具：当 LLM 不确定标准 thscode 代码时，应先调它消歧，再调数据工具。fuyao-meta-mcp 解析标的， fuyao-a-share-mcp 取业务数据，两者配合完成完整链路。

场景一：查询股票行情​

用户："查一下贵州茅台今天的行情"

  1. fuyao-meta-mcp → get_meta_tickers_search，q: "贵州茅台"，获取 thscode: 600519.SH
  2. fuyao-a-share-mcp → get_a_share_prices_snapshot，thscodes: "600519.SH"，获取实时行情

场景二：获取历史走势​

用户："茅台最近一年的日 K 线走势如何？"

  1. fuyao-meta-mcp → get_meta_tickers_search，q: "茅台"，获取 thscode: 600519.SH
  2. 计算当前与一年前的毫秒时间戳
  3. fuyao-a-share-mcp → get_a_share_prices_historical，thscode/interval/start/end/adjust

场景三：获取股票代码表​

用户："列出所有沪深 A 股代码"

  1. fuyao-meta-mcp → get_meta_tickers_list，exchange: "SH,SZ"，asset_type: "a-share"，limit: 1000，offset: 0
  2. 若返回数量等于 limit，递增 offset 继续调用直到取尽

场景四：查询公司财务报表​

用户："茅台最近 3 年的年报利润情况"

  1. fuyao-meta-mcp → get_meta_tickers_search，q: "茅台"，获取 thscode: 600519.SH
  2. fuyao-a-share-mcp → get_a_share_financials_income_statements，thscode: "600519.SH"，period: "annual"，limit: 3

场景五：对比多家公司资产负债​

用户："对比茅台和五粮液最近一期季报的资产负债表"

  1. fuyao-meta-mcp → get_meta_tickers_search，q: "茅台"，获取 thscode: 600519.SH
  2. fuyao-meta-mcp → get_meta_tickers_search，q: "五粮液"，获取 thscode: 000858.SZ
  3. fuyao-a-share-mcp → get_a_share_financials_balance_sheets，thscode: "600519.SH"，period: "quarterly"，limit: 1
  4. fuyao-a-share-mcp → get_a_share_financials_balance_sheets，thscode: "000858.SZ"，period: "quarterly"，limit: 1

场景六：查看交易日历​

用户："最近一年有哪些交易日"

  1. fuyao-a-share-mcp → get_a_share_calendar_trading_days，无参数，返回近一年交易日列表（无需前置检索）

场景七：拉取概念板块成分股​

用户："白酒概念板块都有哪些股票？"

  1. fuyao-a-share-index-mcp → get_a_share_index_catalog_ths_index_list，tag: "cn_concept"， 从返回 item 中匹配 name = "白酒概念" 的 thscode（例如 886042.TI）
  2. fuyao-a-share-index-mcp → get_a_share_index_constituents_ths_stock_list， thscode: "886042.TI"，拿到成分股清单

场景八：取沪深 300 成分股实时行情​

用户："沪深 300 成分股今天的行情"

  1. fuyao-a-share-index-mcp → get_a_share_index_constituents_ths_stock_list， thscode: "000300.SH"，拿到成分股 thscode 列表
  2. 将 thscode 列表逗号拼接（可分批以控制单次请求长度）
  3. fuyao-a-share-mcp → get_a_share_prices_snapshot，thscodes: "..."，批量取实时行情

与 REST 的差异​

  • 认证方式：REST 在请求 header 携带 X-api-key；MCP 通过环境变量 API_KEY 注入。
  • 调用方式：REST 通过 HTTP 客户端调用；MCP 以 MCP Server 形态供 AI Agent 调用。
  • 数据完全一致：两者调用同一套后端 capability，字段、错误码、响应信封完全相同。