FIU Finance Data
FIU Finance MCP Server 是深圳市融聚汇信息科技有限公司推出的金融市场数据 MCP 服务。通过 Streamable HTTP 端点,为 AI 模型提供港股、美股、A股(中华通)、日股、IPO 及全球基金数据,覆盖 100 个端点,支持工具自描述能力,让 AI 精准调用所需数据。
Servidor MCP hospedado
npx add-mcp 'https://ai.szfiu.com/api/mcp/v2'Instala no Claude Code, Codex, Cursor e outros
Documentação
融聚汇FIU MCP服务
覆盖五大金融市场,26 项工具集一站获取
什么是融聚汇MCP 服务?
FIU Finance MCP Server 是深圳市融聚汇信息科技有限公司推出的金融市场数据 MCP 服务。通过 Streamable HTTP 端点,为 AI 模型提供港股、美股、A股(中华通)、日股、IPO 及全球基金数据,覆盖 100 个端点,支持工具自描述能力,让 AI 精准调用所需数据。
业务工具统一返回三态:成功响应包含 code=0 和 resultStatus ,其中 ok 表示有数据, empty 表示调用成功但无业务数据并附带 emptyReason ;参数错误和下游故障通过 MCP isError=true 返回,错误正文包含 resultStatus=error 。
核心能力
- 五大市场覆盖 :港股 / 美股 / A股(中华通)/ 日股 / IPO
- 26 项工具集 :实时行情、K线、财务报表、股权结构、资金流向、期权链、ETF、债券、新闻资讯、财经日历、宏观经济等
- 工具自描述 :内置
describe_tool能力,AI 模型可自行查询任意工具的参数、枚举值与适用市场 - Streamable HTTP 协议 :标准 MCP 协议,兼容主流 AI 客户端
工具列表
本服务提供 26 项金融数据工具,每项工具包含多个端点,共计 100+ 个端点。
market_overview 、 market_flow 、 market_position_cost 、 shareholding_institution 、 macro_economics 、 company_announcements 直接在顶层填写 endpoint 和业务字段。 market_ranking 顶层仅保留 endpoint 和 params ,业务字段填写在 params 中。 describe_tool 按对应工具的结构提供调用示例。
例如调用 market_flow :
{"endpoint":"get_capital_flow","market":"HK","symbol":"00700.hk","flowType":"current"}
字段类型、完整枚举、默认值及条件必填规则,以工具的公开参数定义和 describe_tool 返回内容为准。
1. describe_tool — 工具自描述
帮助 AI 模型在调用前了解任意工具或端点的参数、枚举值、适用市场范围。支持两级详细度: summary (默认紧凑调用契约,含参数类型、必填条件、完整枚举和调用位置)、 params (增加语义说明和有效组合)。已知 endpoint 时可直接查询其完整参数。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
toolNames | string[] | 二选一 | 需要查询的工具集或端点名称,最多 5 个;优先使用此字段。 |
toolName | string | 二选一 | 单个工具集或端点名称;未填写 toolNames 时使用。 |
detail | enum | 否 | 返回详细程度: summary / params ,默认 summary |
使用示例
"帮我查看 get_kline 和 get_financial_statement 这两个端点需要哪些参数"
元工具:search — 证券代码搜索
根据公司名称、证券代码或部分关键词搜索证券标的。适用于用户只提供名称、代码片段,或需要先解析标准证券代码的场景;已知完整 symbol 时可直接调用对应业务工具。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
key | string | 是 | 非空搜索关键词,支持公司名称、证券代码、带.hk / .us / .sh / .sz / .jp 后缀的完整代码或部分关键词,例如 腾讯 、 00700 、 AAPL.us 。 |
返回说明
返回匹配标的列表, symbol 会带市场后缀,可直接作为行情、财务、新闻等工具的入参。无匹配时返回 resultStatus=empty 、 emptyReason=NO_MATCHING_DATA ;参数错误或服务异常返回错误结果。
使用示例
"搜索腾讯的证券代码" / "查找 AAPL.us 对应的美股标的"
2. quote_spot — 证券搜索与快照行情
证券搜索、静态定义、快照行情与扩展报价。支持股票、ETF、指数、权证、债券等多资产类型的实时价格查询,以及证券代码定义、双重柜台、新股列表等静态数据。股票扩展行情支持港股、美股、A股和日股。
get_quote 的基础行情和扩展行情返回紧凑表: columns 是英文字段名, columnNames 是逐列对应的中文名, rows[*][i] 对应 columns[i] 。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_quote / get_security_definition / get_security_profile / search_security |
params | object | 是 | 包含 market (HK/US/CN/JP/GLOBAL)、 assetType (stock/etf/index/warrant/bond)、 symbols (证券代码数组)、 quoteType (basic=基础行情、extended=扩展行情)、 timeMode (0=实时、1=延时,默认 0)等 |
日股扩展行情示例: {"endpoint":"get_quote","params":{"market":"JP","assetType":"stock","symbols":["6758.jp","7203.jp"],"quoteType":"extended","timeMode":0}} 。
日股扩展行情提供委比、流通市值、股息率、每股盈利、市盈率等字段的中文列名。同批证券均为空的字段不返回(包括 null 、缺失值、空字符串及纯空白字符串);某列只要有一个非空值就保留,其他行对应位置用 null 补齐,保持 columns/columnNames/rows 对齐。 0 和 false 不作为空值删除。
使用示例
"腾讯控股现在多少钱?帮我查一下 00700.hk、AAPL.us 和 600519.sh 的最新报价"
3. quote_intraday — 盘中实时数据
get_trade_statistics 的 JP overview 查询必须提供 symbol ; date 格式为 YYYY-MM-DD ,省略时查询日本当地当天。非交易日可能无数据,查询历史成交请指定交易日期。 type 为 0=主买、1=主卖、2=中性盘、3=主买和主卖、4=全部,默认 4。
订单簿(买卖盘)、逐笔成交记录、分时走势图、迷你走势图、交易统计。覆盖港股、美股、A股(中华通)、日股,提供从毫秒级逐笔到分钟级趋势的完整盘中数据。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_intraday_trend / get_mini_trend / get_orderbook / get_trade_history / get_trade_statistics / get_trades |
params | object | 是 | 包含 market 、 symbol 、 historyType (trade)、 statisticsType (overview/detail)等 |
使用示例
"帮我看看 00700.hk 当前的买卖盘口深度" / "展示 AAPL 今天的分时走势图"
4. quote_kline — K 线数据
get_kline 支持 1 分钟到年线的全周期 K 线,前复权/后复权/不复权,单次最多获取 500 根 K 线,当前明确覆盖股票、指数、债券;ETF 需先确认 endpoint。 get_jp_kline 查询日股最近若干根 K 线,支持批量证券;历史快照使用 get_snapshot_history 。
get_kline 返回紧凑表: columns 是英文字段名, columnNames 是逐列对应的中文名, rows[*][i] 对应 columns[i] 。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_kline / get_jp_kline / get_snapshot_history |
params | object | 是 | get_kline 包含 assetType (stock/index/bond)、 symbol 、 period (1m/3m/5m/15m/30m/60m/120m/240m/1d/1w/1mo/1q/1y)、截止日期 date 、 adjust (none/forward/backward)、 limit (默认 100,1~500 的整数)。 |
get_kline 的所有周期均接受 date=YYYY-MM-DD ;分钟 K 也可指定 YYYY-MM-DD HH:mm:ss ,仅传日期表示截至当天 23:59:59(自然日结束,并非交易所收盘)。HK/US/CN/JP 支持股票和指数,默认 assetType=stock ;GLOBAL 仅支持债券,默认 assetType=bond 。CN 日 K 默认 adjust=forward ,其余默认 none ;显式指定优先。日期、市场与资产组合、根数在请求执行前校验。
使用示例
"帮我看 AAPL 最近 60 根日 K 线,前复权"
get_jp_kline 参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
market | string enum | 否 | 仅支持 JP (日股),默认 JP。 |
date | string | 否 | 查询日期/时间。K线类型为日周月季年时,时间必须为格式为"yyyy-MM-dd"这种时间格式。K线类型为分K级别时,时间必须为格式为"yyyy-MM-dd HH:mm:ss"这种时间格式 |
limit | integer | 否 | 查询条数,默认 20 ,范围 1~500 |
symbol | string | 是 | 单只日股证券代码,例如 6758.jp 。 |
symbols | string[] | 否 | 非空批量代码列表,例如 ["6758.jp","7203.jp"] ;同时填写 symbol 时,symbol 须包含在列表中。 |
type | integer enum | 否 | K线类型:0(日)、1(周)、2(月)、3(季)、4(年)、5(1分)、6(5分)、7(15分)、8(30分)、9(60分)、10(120分)、11(3分)、12(240分)。 |
timeMode | integer enum | 否 | 0(实时)、1(延时),默认 0。 |
{"endpoint":"get_jp_kline","params":{"symbol":"6758.jp","symbols":["6758.jp","7203.jp"],"type":11,"limit":20,"timeMode":0}}
type 默认 0(日 K)。省略 date 时查询最新 K 线。返回顶层 meta/format/columns/columnNames/rows ,数据固定为以下 13 列,顺序与表格一致。缺失值保留 null ,数值及字符串精度保持原值,其余数据字段不返回。单只证券的 meta 包含 symbol、market、period、count;批量按 meta.symbols 顺序拼接记录,meta.rowCounts 对应每只证券的记录数(空结果为 0),meta.count 为总根数。
| 返回字段 | 中文含义 |
|---|---|
amount | 成交额 |
amountLast | 总成交额 |
change | 涨跌额 |
changeRate | 涨跌幅 |
close | 收盘价 |
date | 日期 |
high | 最高价 |
low | 最低价 |
open | 开盘价 |
preClose | 昨收价 |
turnoverRate | 换手率 |
volume | 成交量 |
volumeLast | 总成交量 |
5. quote_derivatives_hk — 港股衍生品
窝轮(认购/认沽证)和牛熊证(CBBC)的发行商目录、产品列表、基本资料、历史交易数据、排名统计以及扩展报价。专注港股结构化衍生品市场。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_hk_warrant_catalog / get_hk_warrant_trading_data / get_quote_extend |
params | object | 是 | 包含 warrantType (issuer/list/list_en/profile)、 warrantTradeType (history/rank/statistics)、 symbols 等 |
使用示例
"帮我找腾讯相关的所有窝轮和牛熊证" / "港股窝轮成交排名前十有哪些"
6. quote_us_options — 美股期权链
美股 OPRA 期权链数据:到期日列表、期权链、快照、希腊字母(Greeks)、看涨/看跌成交量统计、期权概况、实时报价、K 线和排名。覆盖美股全市场期权合约。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_us_option_chain / get_us_option_overview / get_us_option_quote / get_us_option_rankings |
params | object | 是 | 包含 optionType (expiration/chain/symbols/snapshot/greeks/callput_volume)、 rankType (list/statistics/top10)、 symbol 等 |
使用示例
"查看 AAPL 的期权链,有哪些到期日可选" / "AAPL 近月看涨期权成交最活跃的是哪个"
7. market_overview — 市场概览
查询港股、美股、A股、日股的实时涨跌家数及涨跌幅分布。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_market_statistics |
market | string enum | 是 | HK / US / CN / JP。 |
返回顶层 columns/columnNames/rows ,每行包含 market (统计范围代码)、 marketName (市场中文说明),各列按相同位置对应。港股展示 ALL=全部市场、MAIN=主板、GEM=创业板;美股展示 ALL=全部市场、Q=Nasdaq全球精选市场、G=Nasdaq全球市场、S=Nasdaq资本市场、N=NYSE纽约交易所、A=NYSE MKT(AMEX)、P=NYSE Arca、Z=BATS交易所、V=Investor's Exchange,LLC(投资者交易所);A股与日股展示 ALL=全部市场。全部市场和分板块不能重复相加。
| 返回字段 | 含义(x 为涨跌幅) |
|---|---|
time | 统计更新时间,保留原始时间值 |
fall4 | 下跌四档家数,x≤-7% |
fall3 | 下跌三档家数,-7%<x<-5% |
fall2 | 下跌二档家数,-5%≤x<-3% |
fall1 | 下跌一档家数,-3%≤x<0% |
fall | 下跌家数,x<0% |
flat | 平盘家数,x=0% |
rise | 上涨家数,x>0% |
rise1 | 上涨一档家数,0%<x≤3% |
rise2 | 上涨二档家数,3%<x≤5% |
rise3 | 上涨三档家数,5%<x<7% |
rise4 | 上涨四档家数,x≥7% |
limitDown/limitUp | A股可用的跌停/涨停家数 |
各范围保留自己的更新时间;缺失值保留 null,空数据不补零。任一范围查询失败时返回错误。
使用示例
"今天港股市场整体表现怎么样?涨跌家数如何?"
8. market_ranking — 多维度排名
覆盖港股、美股、A股、日股排行。只调用 MCP 工具 market_ranking ,顶层必填参数为 endpoint:string enum 和 params:object ;市场由 endpoint 决定,rankType 和其他业务字段全部放入 params,无需 market。四个市场名称是 endpoint,不是独立 MCP 工具。
| endpoint | params.rankType |
|---|---|
get_hk_ranking | stock / industry / ipo / broker / market_premium |
get_us_ranking | stock / industry / ipo / etf |
get_cn_ranking | stock / industry / ipo |
get_jp_ranking | stock / hot_stock / industry |
排序字段、资产类型、默认值与分页能力按 rankType 校验。 describe_tool 查询工具集返回四市场目录;查询市场 endpoint 时返回完整字段字典 parameters、类型差异 variants 和全部 oneOf 分支,按 rankType 选择对应约束。例如查询说明: {"toolNames":["get_hk_ranking"],"detail":"params"} ;调用 market_ranking : {"endpoint":"get_hk_ranking","params":{"rankType":"stock","marketBoard":"MAIN","pageSize":10}} 。
返回统一为顶层 columns/columnNames/rows 紧凑表,保留接口提供的 total ,不返回 semanticTool/data 包装或导航分页字段。完整参数、市场枚举、兼容规则和差异说明见 市场排行调用契约 。以下参数表仅说明原 market_ranking.get_rankings 入口,不用于新市场工具。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_rankings |
market | string enum | 是 | HK / US / CN / JP。 |
rankType | string enum | 是 | stock / industry / ipo / broker / market_premium / etf / hot_stock;具体市场组合见参数说明。 |
marketBoard | string | 否 | 市场板块代码。 |
assetType | string enum | 否 | stock / etf / warrant / bond / trust / adr / common,默认 stock。 |
stockKind | string | 否 | 美股股票集合。 |
conceptFlag | string enum | 否 | Y=概念、N=行业,默认 N。 |
symbol | string | 否 | 经纪商等排行使用的证券代码。 |
date | string | 否 | 查询日期,YYYY-MM-DD。 |
price | number | 否 | 指定价格。 |
types | integer[] | 否 | 美股 ETF 排行周期列表,默认 [0]。 |
state | string | 否 | 日股交易状态。 |
sessionId | integer enum | 否 | -1=盘前、1=盘中、-2=盘后,默认 1。 |
sortField | string enum | 否 | changeRate =涨跌幅、 amount =成交额、 volume =成交量,默认 changeRate 。 |
sortType | integer enum | 否 | 0=升序、1=降序,默认 1。 |
timeMode | integer enum | 否 | 0=实时、1=延时,默认 0。 |
pageNum | integer | 否 | 页码,从 1 开始,默认 1。 |
pageSize | integer | 否 | 每页数量,默认 20,最大 200。 |
使用示例
"今天港股涨幅前十的股票有哪些?" / "A 股哪些行业板块涨得最好"
9. market_flow — 资金流向
单只股票的当日资金流向、近60日资金流向和资金分布。支持港股、美股、A股、日股。
资金流返回采用紧凑表结构: columns 为英文字段名, columnNames 为对应中文含义, rows 按列位置返回数据。常见字段包括: capitalBigFunds =大单资金流向、 capitalLargeFunds =特大单资金流向、 capitalMidFunds =中单资金流向、 capitalSmallFunds =小单资金流向、 totalFunds =整体资金流向、 changeRate =涨跌幅、 close =收盘价、 date / time =时间; capitalInTotal =主动买入总额、 capitalInLarge =主动买入超大单、 capitalInBig =主动买入大单、 capitalInMid =主动买入中单、 capitalInSmall =主动买入小单; capitalOutTotal =主动卖出总额、 capitalOutLarge =主动卖出超大单、 capitalOutBig =主动卖出大单、 capitalOutMid =主动卖出中单、 capitalOutSmall =主动卖出小单。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_capital_flow |
market | string enum | 是 | HK / US / CN / JP。 |
symbol | string | 是 | 证券、指数或板块代码。 |
flowType | string enum | 是 | current=当日资金流向、daily=近60日资金流向、distribution=资金分布。 |
使用示例
"00700.hk 最近资金是流入还是流出?主力资金动向如何?"
10. market_structure — 市场结构
指数成分股及映射关系、行业分类及行业成分股、市场微观结构(买卖价差、AH 溢价、双重柜台、券商列表)。支持港股、美股、A股(中华通)、日股。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_index_data / get_industry_data / get_market_microstructure |
params | object | 是 | 包含 market 、 indexType (list/quote/constituent/mapping/capital_distribution)、 industryType (list/rank/constituent/belong_quote)、 dataType (spread/market_premium/double_counter/broker_list)等 |
使用示例
"恒生指数成分股有哪些?" / "贵州茅台属于哪个行业板块?"
11. market_position_cost — 持仓成本
筹码分布区间和筹码集中度分析,帮助判断支撑位、压力位和主力持仓成本。支持港股和美股市场。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_position_cost |
market | string enum | 是 | HK / US。 |
symbol | string | 是 | 证券代码。 |
costType | string enum | 是 | range=指定价格获利比例、distribution=筹码移动分布。 |
date | string | 否 | 查询日期,YYYY-MM-DD;默认今天。 |
price | number | 条件必填 | 指定价格。 |
high | number | 条件必填 | 最高价。 |
low | number | 条件必填 | 最低价。 |
使用示例
"帮我看看 00700.hk 的筹码分布,当前持仓成本集中在什么区间?"
12. f10_profile — 公司概况
公司简介、管理层信息、扩展资料(并行数据、扩展全貌)和统一行业归属。覆盖港股、美股、A股(中华通),按市场自动汇总可用的公司资料,并清理空值和重复字段。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_company_profile / get_company_management / get_company_extra_profile |
params | object | 是 | 包含 market 、 symbol |
使用示例
"腾讯控股的公司简介和管理层有哪些人?" / "帮我查一下苹果公司的基本信息"
13. f10_financials — 财务报表
利润表(income)、资产负债表(balance)、现金流量表(cash)三大报表,以及 ROE、毛利率、净利率、资产负债率等关键财务比率指标。支持港股、美股、A股(中华通)。
get_financial_statement 和 get_financial_indicator 与行情域使用相同的顶层紧凑表契约,不再包含 semanticTool/data 包装: columns 是英文字段名, columnNames 是逐列对应的中文名, rows[*][i] 对应 columns[i] 。中文名优先采用清洗后的对应数据接口定义。完整财务表按元数据、资产、负债、权益、收入、成本费用、利润、经营/投资/融资现金流、现金汇总、每股指标、财务比率、调整项和其他字段排列,基础值与对应 YoY 字段相邻。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_financial_statement / get_financial_indicator |
params | object | 是 | 包含 market 、 symbol 、 statementType (income/balance/cash,默认 income)、 reportType (HK: F/I/P/Q1-Q4;US: FY/I1/I2/Q1-Q4;CN: 1/6/9/12/99)等 |
三市场均支持通过 reportType 筛选报告期。返回行保留 coverMonths : 3 表示单季, 6 表示前二季度/上半年累计, 9 表示前三季度累计, 12 表示前四季度/年报累计;美股第三季度数据按 coverMonths 区分第三季度单季和前三季度累计,并统一返回公开报告期 Q3 。存在明确口径时同时返回 periodScope ( quarter / cumulative )和 periodDescription 。
使用示例
"贵州茅台最新一期利润表" / "腾讯近三年的 ROE 和毛利率变化趋势"
14. f10_business_governance — 业务与治理
主营业务收入分部分析、分红记录、拆股/合股历史、股东大会、持股变动、股份回购、股本结构等公司行为数据。覆盖港股、美股、A股(中华通)。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_business_segment / get_company_action |
params | object | 是 | 包含 market 、 symbol 、 actionType (dividends/splits/meeting/hold_change/repurchase/share_structure)等 |
使用示例
"腾讯的业务收入主要来自哪些板块?" / "苹果近三年的分红记录"
15. shareholding_structure — 股权结构
主要股东、当前股东、股东详情、前十大股东,以及持股变动记录。覆盖港股、美股、A股(中华通),帮助了解公司股权集中度与大股东增减持动向。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_shareholders / get_shareholding_change |
params | object | 是 | 包含 market 、 symbol 、 holdingType (major/current/detail/topten)等 |
使用示例
"腾讯的前十大股东是谁?" / "最近有没有大股东减持 00700.hk?"
16. shareholding_institution — 美股机构持仓
机构持股明细和机构持股统计。覆盖美股市场,展示机构投资者的持仓数量、比例、变动趋势,是跟踪美股机构动向的核心工具。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_institution_holding |
market | string enum | 是 | 市场代码,目前只支持 US(美股)。 |
holdingType | string enum | 是 | detail=机构持股明细、statistics=机构持股统计。 |
symbol | string | 是 | 证券代码,需带.US 或 .us 后缀,例如 AAPL.US。 |
symbols | string[] | 否 | 批量证券代码列表,需带.US 或 .us 后缀,例如 ["BABA.US", "AAPL.us"]。 |
返回字段
holdingType=detail : symbol 证券代码、 holderName 股东名称、 holdingNumber 持股数、 holdingRatio 持股比例、 changeNumber 变动股数、 changeRatio 变动比例、 reportDate 发布日期。
holdingType=statistics : symbol 证券代码、 total 机构总数、 totalChange 机构总数较上期变动、 holdingNumber 持股数、 holdingNumberChange 持股数较上期变动、 holdingRatio 持股比例、 holdingRatioChange 持股比例较上期变动环比、 reportDate 报告日期、 neworgnum 新进机构数、 addedorgnum 增持机构数、 reduceorgnum 减持机构数、 price 股价。
使用示例
"有哪些机构持有 AAPL?最近机构是在加仓还是减仓?"
17. shareholding_fund_broker — 券商/沽空
券商持仓比例与排名、沽空(卖空)数据。覆盖港股和美股。基金持仓、基金成分、净值和业绩统一使用 fund_etf 。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_broker_holding / get_short_sell |
params | object | 是 | 包含 holdingType (ratio/detail/statistics/rank/f10_ratio)、 symbol 等 |
使用示例
"00700.hk 的沽空比例是多少?" / "哪些券商席位持有腾讯?"
18. fund_etf — 基金与 ETF
全球基金搜索、基本资料、经理、分红、费率、净值、业绩、风险、完整持仓、资产/行业/国家配置、基准、销售市场、比较、排行、筛选与国家代码解析。基金按 fund_id 或 fund_class_id 查询,不使用交易市场字段;只有名称或 Ticker 时先搜索,已有稳定 ID 时直接调用目标 endpoint。
分层描述
describe_tool 可查询 fund_etf 工具集或单个 endpoint 的说明。已知 endpoint 时直接查询其完整参数,并根据 mode、operation 或 kind 的有效组合填写业务请求。无需每次重复读取工具集说明;已知参数可直接调用。
{"toolNames":["fund_etf"],"detail":"summary"}
{"toolNames":["get_fund_nav"],"detail":"params"}
基金 ID、业务分页和日期规则以单 endpoint 的参数说明为准。
紧凑返回
get_fund_nav(operation=history) 、 get_fund_holdings(operation=history) 、 rank_funds 、 screen_funds 返回顶层 format/columns/columnNames/rows ,不再使用 semanticTool/data 包装。 columns[i] 、 columnNames[i] 、 rows[*][i] 严格按位置对应。
- 保留实际返回的
meta(基金和份额标识、数据日期、估算标记、警告等)。 - 保留
page、page_size、has_more、next_page,接口提供total时也保留;不自动翻页。 - 记录中的份额类别、币种、日期以及原始数值均保留,不跨份额、币种或日期汇总,不换算收益率、权重或币种;缺失值不填零。
- 空列表保留表结构、元数据及分页。未知字段保留,并显式标注缺少中文名。
- 最新净值、当前/前十大持仓及其余 endpoint 保持原有返回格式。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | search_funds / get_fund_profile / get_fund_managers / get_fund_distributions / get_fund_terms / get_fund_nav / get_fund_performance / compare_funds / get_fund_risk / rank_funds / screen_funds / get_fund_holdings / get_fund_exposure / get_fund_benchmark / get_fund_sales_markets / get_country_code |
params | object | 是 | 基金引用使用 fund_id 或 fund_class_id ;分页使用 page (从 0 开始)和 page_size (最大 200);日期使用 start_date / end_date |
使用示例
"搜索代码为 DRAM 的基金,并查询它的完整持仓" / "比较这几只基金的资料和近一年表现"
19. stock_connect — 沪深港通
北向/南向资金额度使用、净成交额、累计净流入、持股比例、成交排名、持股变动率排名、资金流向分布。覆盖港股通和陆股通双向数据。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_stock_connect_data / get_hk_stock_connect_data / get_cn_stock_connect_data |
params | object | 是 | 包含 connectType (minute_flow/balance/cumulative_net_turnover_in/cumulative_net_flow/net_turnover/rank_change_rate/rank_net_turnover_in/rank_shareholdings/rank_traded/shareholding_ratio/turnover_flow 等)、 marketBoard (ALL/SH/SZ)等 |
使用示例
"今天北向资金是流入还是流出?" / "沪股通持仓比例最高的 A 股有哪些?"
20. ipo — IPO 新股
港股和美股 IPO 日历、新股列表(招股中/待上市/已上市)、发行详情、公司资料、承销商/保荐人、基石投资者、孖展(融资)信息、排名、市场数据、认购工具、IPO 新闻、话题、课程和标签。覆盖 IPO 全流程,共 20 个端点。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_hk_ipo_calendar / get_hk_ipo_list / get_hk_ipo_detail / get_hk_ipo_company_profile / get_hk_ipo_underwriter / get_hk_ipo_cornerstone_investor / get_hk_ipo_margin_info / get_hk_ipo_notice / get_hk_ipo_rankings / get_hk_ipo_market_data / get_hk_ipo_subscription_tools / get_us_ipo_list / get_us_ipo_detail / get_us_ipo_underwriter / get_us_ipo_market_data / get_ipo_news / get_ipo_topic / get_ipo_course / get_ipo_tags / search_ipo_content |
params | object | 是 | 包含 ipoType (calendar/make_new/today/to_be_listed/listed/offering/company_info/margin 等)、 symbol 、 ipoMarketType 、 contentType 等 |
使用示例
"本周港股有哪些新股在招股?" / "帮我查一下某 IPO 的基石投资者和孖展情况"
21. bond_basic — 债券基础
债券搜索、债券概况、快照报价、订单簿。使用 market=GLOBAL 进行跨市场债券查询,证券代码可使用 ISIN 编码。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | search_bond / get_bond_profile / get_bond_quote / get_bond_orderbook |
params | object | 是 | 包含 market (GLOBAL)、 symbol (支持 ISIN)、 keyword 等 |
使用示例
"帮我搜索某 ISIN 对应的债券基本信息" / "查看这只债券的实时报价"
22. bond_analytics — 债券分析
债券排名、债券图表(收益率曲线等)、债券收益率、债券交易状态。使用 market=GLOBAL ,提供债券市场的深度分析功能。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_bond_rankings / get_bond_chart / get_bond_yield / get_bond_trading_status |
params | object | 是 | 包含 market (GLOBAL)、 symbol 、 chartType 等 |
使用示例
"查看这只债券的收益率曲线" / "当前债券市场收益率排名"
23. fiu_news — 金融资讯
最新新闻、关键词搜索、语义搜索、个股相关新闻、新闻详情、关联新闻、新闻统计、新闻摘要。覆盖港股、美股、A股(中华通)、日股,支持标题/摘要/关键词搜索及语义级别的智能匹配,共 8 个端点。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | news_latest / news_search / news_semantic_search / news_by_symbol / news_get / news_related / news_count / news_digest |
params | object | 是 | 包含 market (HK/US/CN/JP/GLOBAL)、 query (搜索关键词)、 symbol 、 id 、 limit (默认 10,最大 50)、 hours (默认 24,最大 168)等 |
使用示例
"最近 24 小时关于腾讯的新闻有哪些?" / "搜索港股市场关于 AI 的最新新闻"
24. financial_calendar — 财经日历
查询全球财经日历,支持按标题关键词、日期范围、国家/地区、市场、事件类型和重要等级筛选,并可按事件 ID 查询详情。覆盖经济数据发布、重要事件、权息和休市安排。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | search_financial_calendar / get_financial_event_detail |
params | object | 是 | 搜索时 date (开始日期,YYYY-MM-DD)和 keyword (标题关键词)必填;可选 endDate 、 direction (-1=向未来,1=向历史)、 limit 、 countryTypes 、 eventTypes 、 markets 、 importanceLevels 。查询详情时传 id (搜索结果中的事件 ID)。 |
返回说明
搜索返回按日期组织的财经事件及事件 ID;详情接口返回单个事件的完整字段。未传 endDate 时使用 direction 和 limit 控制滚动日期窗口。
使用示例
"查询未来一周美国的重要经济数据" / "查看财经日历事件 ID 12345 的详情"
25. macro_economics — 宏观经济
查询精选宏观经济指标的最新数据,例如货币供应量、利率、通胀、就业、GDP、贸易和 PMI 等。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_macro_overview |
titleId | integer enum | 是 | 宏观指标标题 ID:10=央行资产负债表、20=M2 同比、30=LPR、40=PPI、50=城镇调查失业率、60=固定资产投资、70=社会消费品零售、80=GDP、90=贸易余额、100=CPI、110=制造业 PMI。 |
返回说明
返回指定 titleId 指标的最新数据,内容包含指标名称、发布时间、数值及同比/环比等可用字段。
使用示例
"查询中国 CPI 最新数据" / "获取当前精选宏观经济指标"
company_announcements — 上市公司公告
查询港股、美股和 A 股上市公司公告。公告记录包含附件地址或正文;附件获取失败时保留该条公告并标记附件状态。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string enum | 是 | get_company_announcements。 |
market | string enum | 是 | HK / US / CN。 |
symbols | string[] | 是 | 至少一个证券代码,例如 ["00700.hk"]。 |
startDate | string | 否 | 公告开始日期,YYYY-MM-DD。 |
endDate | string | 否 | 公告结束日期,YYYY-MM-DD。 |
调用示例
{"endpoint":"get_company_announcements","market":"HK","symbols":["00700.hk"]}
26. reference — 参考数据
ISIN/SEDOL/CIK 代码查询、货币代码、交易时段、除权日、退市记录、证券代码映射(股票/指数)、市场交易日历。覆盖港股、美股、A股(中华通)、日股,债券参考数据使用 market=GLOBAL ,共 4 个端点。
输入参数
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
endpoint | string | 是 | get_reference_data / get_symbol_mapping / get_trading_status / get_market_hours |
params | object | 是 | 包含 referenceType (isin/sedol/trade_symbol/warrant_related/currency/basic_symbol/cik/adr/bond_codes/yield_codes / stock/index)、 statusType (trade_date/session/exright/security/delisted/current/bond_session/yield_session)、 symbol 等 |
使用示例
"帮我查 00700.hk 的 ISIN 代码" / "今天港股是否交易日?交易时段是什么?"
接入配置
前置条件
- 访问 ai.szfiu.com 申请 API Key
- HTTP 直连需要支持 Streamable HTTP 协议的 MCP 客户端
- npm/npx 接入需要 Node.js 20.18.1 或更高版本
通过 npm/npx 接入
无需安装即可启动本地 stdio 适配器:
# macOS / Linux
FIU_API_KEY=YOUR_API_KEY npx -y fiu-finance-mcp
# Windows PowerShell
$env:FIU_API_KEY="YOUR_API_KEY"
npx -y fiu-finance-mcp
也可以全局安装:
npm install -g fiu-finance-mcp
fiu-finance-mcp --api-key YOUR_API_KEY
Claude Desktop、Cursor 等使用 stdio 的客户端可配置为:
{
"mcpServers": {
"fiu-finance": {
"command": "npx",
"args": ["-y", "fiu-finance-mcp"],
"env": {
"FIU_API_KEY": "YOUR_API_KEY"
}
}
}
}
CLI 参数:
| 参数 | 说明 |
|---|---|
-k, --api-key <key> | FIU API Key,优先级高于 FIU_API_KEY 环境变量 |
-u, --url <url> | 覆盖远程 MCP 地址,默认 https://ai.szfiu.com/api/mcp/v2 |
--header <Name:Value> | 添加自定义请求头,可重复使用并支持 ${ENV_NAME} |
--debug | 启用代理调试日志 |
--silent | 仅输出错误日志 |
-h, --help | 显示帮助 |
-v, --version | 显示 CLI 版本 |
--connect-timeout 、 --headers-timeout 、 --body-timeout 、 --keep-alive 、 --ping-interval 、 --ipv4 和 --ignore-tool 等参数会传递给底层代理。
Streamable HTTP 直连
在 MCP 客户端配置文件中添加:
{
"mcpServers": {
"fiu-finance": {
"type": "streamableHttp",
"url": "https://ai.szfiu.com/api/mcp/v2",
"headers": {
"Authorization": "Bearer YOUR_API_KEY"
}
}
}
}
Claude Code 一行命令接入:
claude mcp add --transport http fiu-finance https://ai.szfiu.com/api/mcp/v2 \
--header "Authorization: Bearer YOUR_API_KEY"
配置完成后重启 MCP 客户端即可使用。
认证方式
API Key 认证:在 HTTP Header 中传入 Authorization: Bearer YOUR_API_KEY ,每个请求均需携带。
服务端说明
本仓库包含 npm CLI 客户端适配层,不包含业务服务端源码。服务端由深圳市融聚汇信息科技有限公司统一维护和运营,客户通过 API Key 接入后即可使用全部功能。
兼容平台
Claude Code、Claude Desktop、Cherry Studio、Cursor、ChatWise 及任何支持 Streamable HTTP 协议的 MCP 客户端。
版本信息
- MCP 服务:v2.0.0
- npm CLI:v1.0.0
相关资源
服务开通
访问 https://ai.szfiu.com 查看定价方案并申请 API Key。
通信协议
MCP Streamable HTTP 协议