# FIU MCP 产品说明与接入手册

> FIU MCP 金融数据工具文档，包含 26 个业务工具集、104 个端点，以及接入配置、参数契约和调用示例。文档基线：2026-10-23。

FIU MCP 服务地址：https://ai.szfiu.com/api/mcp/v2
npm 包名：fiu-finance-mcp。npm/npx 接入需要 Node.js 20.18.1 或更高版本。
API Key 在 https://ai.szfiu.com 申请，通过 Authorization: Bearer 请求头传递。

endpoint 是工具集内的业务能力标识，不是独立 HTTP URL。多数工具集将业务参数放在 arguments.params，具体以每个端点的参数表为准。

## 完整文档

- [FIU MCP 全文](/guide/llms-full.txt)：完整产品说明、全部端点入参和调用示例。查询具体契约时优先读取此文件。
- [HTML 文档](/guide/)：可浏览、搜索的产品文档。

## 章节索引

- [产品与 MCP 介绍](/guide/#overview)：协议、连接架构、数据能力与边界。
- [接入配置指引](/guide/#connection)：npm/npx、stdio、Streamable HTTP、客户端配置及连接验证。
- [工具调用规则](/guide/#calling)：调用流程、参数层级、证券标识、市场与日期。
- [工具集与端点功能总表](/guide/#catalog)：26 个工具集、104 个端点的中文名称、功能和下游 API 数量。
- [端点入参明细](/guide/#parameters)：每个端点的参数类型、必填条件、默认值、枚举及请求示例。
- [返回结果说明](/guide/#responses)：MCP 封装、业务数据、空结果和错误处理。
- [常见问题与排错](/guide/#troubleshooting)：接入、鉴权和查询问题。
- [版本与验证范围](/guide/#sources)：文档基线、验证方法和验证边界。

## 使用边界

远端部署版本不同时，以实际 tools/list 和 describe_tool 返回为准。
104 个端点示例经本地 MCP 参数与适配链路校验，在下游调用边界拦截；未验证生产连接或真实数据返回。需要真实业务 ID 的示例使用明确占位符。
数据查询不构成投资建议，本文不提供交易执行能力。

## 当前契约要点

- 工具清单：26 个业务工具集、104 个端点，另有 describe_tool 和 search，共 28 个工具。
- 三表 get_financial_statement 不公开 metric；查询关键指标请读取 get_financial_indicator 契约。
- K 线 limit 为请求上限，meta.count 为实际行数；CN 日 K 默认前复权。
- reference 按市场和类型选择参数分支；债券分页、证券状态和批量映射按实际覆盖读取。
- describe_tool 当前公开字段只有 toolNames、toolName、detail；按 endpoint 名查询完整契约。
- 外层参数位置以 tools/list.inputSchema 为准；timeMode 按市场和分支判断。
- 本文按当前工作区核对，包含可能尚未部署的实现。