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 项工具集一站获取

License MCP Markets Toolsets


什么是融聚汇MCP 服务?

FIU Finance MCP Server 是深圳市融聚汇信息科技有限公司推出的金融市场数据 MCP 服务。通过 Streamable HTTP 端点,为 AI 模型提供港股、美股、A股(中华通)、日股、IPO 及全球基金数据,覆盖 100 个端点,支持工具自描述能力,让 AI 精准调用所需数据。

业务工具统一返回三态:成功响应包含 code=0resultStatus ,其中 ok 表示有数据, empty 表示调用成功但无业务数据并附带 emptyReason ;参数错误和下游故障通过 MCP isError=true 返回,错误正文包含 resultStatus=error

核心能力

  • 五大市场覆盖 :港股 / 美股 / A股(中华通)/ 日股 / IPO
  • 26 项工具集 :实时行情、K线、财务报表、股权结构、资金流向、期权链、ETF、债券、新闻资讯、财经日历、宏观经济等
  • 工具自描述 :内置 describe_tool 能力,AI 模型可自行查询任意工具的参数、枚举值与适用市场
  • Streamable HTTP 协议 :标准 MCP 协议,兼容主流 AI 客户端

工具列表

本服务提供 26 项金融数据工具,每项工具包含多个端点,共计 100+ 个端点。

market_overviewmarket_flowmarket_position_costshareholding_institutionmacro_economicscompany_announcements 直接在顶层填写 endpoint 和业务字段。 market_ranking 顶层仅保留 endpointparams ,业务字段填写在 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 时可直接查询其完整参数。

输入参数

参数类型必填说明
toolNamesstring[]二选一需要查询的工具集或端点名称,最多 5 个;优先使用此字段。
toolNamestring二选一单个工具集或端点名称;未填写 toolNames 时使用。
detailenum返回详细程度: summary / params ,默认 summary

使用示例

"帮我查看 get_kline 和 get_financial_statement 这两个端点需要哪些参数"


元工具:search — 证券代码搜索

根据公司名称、证券代码或部分关键词搜索证券标的。适用于用户只提供名称、代码片段,或需要先解析标准证券代码的场景;已知完整 symbol 时可直接调用对应业务工具。

输入参数

参数类型必填说明
keystring非空搜索关键词,支持公司名称、证券代码、带.hk / .us / .sh / .sz / .jp 后缀的完整代码或部分关键词,例如 腾讯00700AAPL.us

返回说明

返回匹配标的列表, symbol 会带市场后缀,可直接作为行情、财务、新闻等工具的入参。无匹配时返回 resultStatus=emptyemptyReason=NO_MATCHING_DATA ;参数错误或服务异常返回错误结果。

使用示例

"搜索腾讯的证券代码" / "查找 AAPL.us 对应的美股标的"


2. quote_spot — 证券搜索与快照行情

证券搜索、静态定义、快照行情与扩展报价。支持股票、ETF、指数、权证、债券等多资产类型的实时价格查询,以及证券代码定义、双重柜台、新股列表等静态数据。股票扩展行情支持港股、美股、A股和日股。

get_quote 的基础行情和扩展行情返回紧凑表: columns 是英文字段名, columnNames 是逐列对应的中文名, rows[*][i] 对应 columns[i]

输入参数

参数类型必填说明
endpointstringget_quote / get_security_definition / get_security_profile / search_security
paramsobject包含 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 对齐。 0false 不作为空值删除。

使用示例

"腾讯控股现在多少钱?帮我查一下 00700.hk、AAPL.us 和 600519.sh 的最新报价"


3. quote_intraday — 盘中实时数据

get_trade_statistics 的 JP overview 查询必须提供 symboldate 格式为 YYYY-MM-DD ,省略时查询日本当地当天。非交易日可能无数据,查询历史成交请指定交易日期。 type 为 0=主买、1=主卖、2=中性盘、3=主买和主卖、4=全部,默认 4。

订单簿(买卖盘)、逐笔成交记录、分时走势图、迷你走势图、交易统计。覆盖港股、美股、A股(中华通)、日股,提供从毫秒级逐笔到分钟级趋势的完整盘中数据。

输入参数

参数类型必填说明
endpointstringget_intraday_trend / get_mini_trend / get_orderbook / get_trade_history / get_trade_statistics / get_trades
paramsobject包含 marketsymbolhistoryType (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]

输入参数

参数类型必填说明
endpointstringget_kline / get_jp_kline / get_snapshot_history
paramsobjectget_kline 包含 assetType (stock/index/bond)、 symbolperiod (1m/3m/5m/15m/30m/60m/120m/240m/1d/1w/1mo/1q/1y)、截止日期 dateadjust (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 参数

参数类型必填说明
marketstring enum仅支持 JP (日股),默认 JP。
datestring查询日期/时间。K线类型为日周月季年时,时间必须为格式为"yyyy-MM-dd"这种时间格式。K线类型为分K级别时,时间必须为格式为"yyyy-MM-dd HH:mm:ss"这种时间格式
limitinteger查询条数,默认 20 ,范围 1~500
symbolstring单只日股证券代码,例如 6758.jp
symbolsstring[]非空批量代码列表,例如 ["6758.jp","7203.jp"] ;同时填写 symbol 时,symbol 须包含在列表中。
typeinteger enumK线类型:0(日)、1(周)、2(月)、3(季)、4(年)、5(1分)、6(5分)、7(15分)、8(30分)、9(60分)、10(120分)、11(3分)、12(240分)。
timeModeinteger enum0(实时)、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)的发行商目录、产品列表、基本资料、历史交易数据、排名统计以及扩展报价。专注港股结构化衍生品市场。

输入参数

参数类型必填说明
endpointstringget_hk_warrant_catalog / get_hk_warrant_trading_data / get_quote_extend
paramsobject包含 warrantType (issuer/list/list_en/profile)、 warrantTradeType (history/rank/statistics)、 symbols

使用示例

"帮我找腾讯相关的所有窝轮和牛熊证" / "港股窝轮成交排名前十有哪些"


6. quote_us_options — 美股期权链

美股 OPRA 期权链数据:到期日列表、期权链、快照、希腊字母(Greeks)、看涨/看跌成交量统计、期权概况、实时报价、K 线和排名。覆盖美股全市场期权合约。

输入参数

参数类型必填说明
endpointstringget_us_option_chain / get_us_option_overview / get_us_option_quote / get_us_option_rankings
paramsobject包含 optionType (expiration/chain/symbols/snapshot/greeks/callput_volume)、 rankType (list/statistics/top10)、 symbol

使用示例

"查看 AAPL 的期权链,有哪些到期日可选" / "AAPL 近月看涨期权成交最活跃的是哪个"


7. market_overview — 市场概览

查询港股、美股、A股、日股的实时涨跌家数及涨跌幅分布。

输入参数

参数类型必填说明
endpointstringget_market_statistics
marketstring enumHK / 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/limitUpA股可用的跌停/涨停家数

各范围保留自己的更新时间;缺失值保留 null,空数据不补零。任一范围查询失败时返回错误。

使用示例

"今天港股市场整体表现怎么样?涨跌家数如何?"


8. market_ranking — 多维度排名

覆盖港股、美股、A股、日股排行。只调用 MCP 工具 market_ranking ,顶层必填参数为 endpoint:string enumparams:object ;市场由 endpoint 决定,rankType 和其他业务字段全部放入 params,无需 market。四个市场名称是 endpoint,不是独立 MCP 工具。

endpointparams.rankType
get_hk_rankingstock / industry / ipo / broker / market_premium
get_us_rankingstock / industry / ipo / etf
get_cn_rankingstock / industry / ipo
get_jp_rankingstock / 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 入口,不用于新市场工具。

输入参数

参数类型必填说明
endpointstringget_rankings
marketstring enumHK / US / CN / JP。
rankTypestring enumstock / industry / ipo / broker / market_premium / etf / hot_stock;具体市场组合见参数说明。
marketBoardstring市场板块代码。
assetTypestring enumstock / etf / warrant / bond / trust / adr / common,默认 stock。
stockKindstring美股股票集合。
conceptFlagstring enumY=概念、N=行业,默认 N。
symbolstring经纪商等排行使用的证券代码。
datestring查询日期,YYYY-MM-DD。
pricenumber指定价格。
typesinteger[]美股 ETF 排行周期列表,默认 [0]。
statestring日股交易状态。
sessionIdinteger enum-1=盘前、1=盘中、-2=盘后,默认 1。
sortFieldstring enumchangeRate =涨跌幅、 amount =成交额、 volume =成交量,默认 changeRate
sortTypeinteger enum0=升序、1=降序,默认 1。
timeModeinteger enum0=实时、1=延时,默认 0。
pageNuminteger页码,从 1 开始,默认 1。
pageSizeinteger每页数量,默认 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 =主动卖出小单。

输入参数

参数类型必填说明
endpointstringget_capital_flow
marketstring enumHK / US / CN / JP。
symbolstring证券、指数或板块代码。
flowTypestring enumcurrent=当日资金流向、daily=近60日资金流向、distribution=资金分布。

使用示例

"00700.hk 最近资金是流入还是流出?主力资金动向如何?"


10. market_structure — 市场结构

指数成分股及映射关系、行业分类及行业成分股、市场微观结构(买卖价差、AH 溢价、双重柜台、券商列表)。支持港股、美股、A股(中华通)、日股。

输入参数

参数类型必填说明
endpointstringget_index_data / get_industry_data / get_market_microstructure
paramsobject包含 marketindexType (list/quote/constituent/mapping/capital_distribution)、 industryType (list/rank/constituent/belong_quote)、 dataType (spread/market_premium/double_counter/broker_list)等

使用示例

"恒生指数成分股有哪些?" / "贵州茅台属于哪个行业板块?"


11. market_position_cost — 持仓成本

筹码分布区间和筹码集中度分析,帮助判断支撑位、压力位和主力持仓成本。支持港股和美股市场。

输入参数

参数类型必填说明
endpointstringget_position_cost
marketstring enumHK / US。
symbolstring证券代码。
costTypestring enumrange=指定价格获利比例、distribution=筹码移动分布。
datestring查询日期,YYYY-MM-DD;默认今天。
pricenumber条件必填指定价格。
highnumber条件必填最高价。
lownumber条件必填最低价。

使用示例

"帮我看看 00700.hk 的筹码分布,当前持仓成本集中在什么区间?"


12. f10_profile — 公司概况

公司简介、管理层信息、扩展资料(并行数据、扩展全貌)和统一行业归属。覆盖港股、美股、A股(中华通),按市场自动汇总可用的公司资料,并清理空值和重复字段。

输入参数

参数类型必填说明
endpointstringget_company_profile / get_company_management / get_company_extra_profile
paramsobject包含 marketsymbol

使用示例

"腾讯控股的公司简介和管理层有哪些人?" / "帮我查一下苹果公司的基本信息"


13. f10_financials — 财务报表

利润表(income)、资产负债表(balance)、现金流量表(cash)三大报表,以及 ROE、毛利率、净利率、资产负债率等关键财务比率指标。支持港股、美股、A股(中华通)。

get_financial_statementget_financial_indicator 与行情域使用相同的顶层紧凑表契约,不再包含 semanticTool/data 包装: columns 是英文字段名, columnNames 是逐列对应的中文名, rows[*][i] 对应 columns[i] 。中文名优先采用清洗后的对应数据接口定义。完整财务表按元数据、资产、负债、权益、收入、成本费用、利润、经营/投资/融资现金流、现金汇总、每股指标、财务比率、调整项和其他字段排列,基础值与对应 YoY 字段相邻。

输入参数

参数类型必填说明
endpointstringget_financial_statement / get_financial_indicator
paramsobject包含 marketsymbolstatementType (income/balance/cash,默认 income)、 reportType (HK: F/I/P/Q1-Q4;US: FY/I1/I2/Q1-Q4;CN: 1/6/9/12/99)等

三市场均支持通过 reportType 筛选报告期。返回行保留 coverMonths3 表示单季, 6 表示前二季度/上半年累计, 9 表示前三季度累计, 12 表示前四季度/年报累计;美股第三季度数据按 coverMonths 区分第三季度单季和前三季度累计,并统一返回公开报告期 Q3 。存在明确口径时同时返回 periodScopequarter / cumulative )和 periodDescription

使用示例

"贵州茅台最新一期利润表" / "腾讯近三年的 ROE 和毛利率变化趋势"


14. f10_business_governance — 业务与治理

主营业务收入分部分析、分红记录、拆股/合股历史、股东大会、持股变动、股份回购、股本结构等公司行为数据。覆盖港股、美股、A股(中华通)。

输入参数

参数类型必填说明
endpointstringget_business_segment / get_company_action
paramsobject包含 marketsymbolactionType (dividends/splits/meeting/hold_change/repurchase/share_structure)等

使用示例

"腾讯的业务收入主要来自哪些板块?" / "苹果近三年的分红记录"


15. shareholding_structure — 股权结构

主要股东、当前股东、股东详情、前十大股东,以及持股变动记录。覆盖港股、美股、A股(中华通),帮助了解公司股权集中度与大股东增减持动向。

输入参数

参数类型必填说明
endpointstringget_shareholders / get_shareholding_change
paramsobject包含 marketsymbolholdingType (major/current/detail/topten)等

使用示例

"腾讯的前十大股东是谁?" / "最近有没有大股东减持 00700.hk?"


16. shareholding_institution — 美股机构持仓

机构持股明细和机构持股统计。覆盖美股市场,展示机构投资者的持仓数量、比例、变动趋势,是跟踪美股机构动向的核心工具。

输入参数

参数类型必填说明
endpointstringget_institution_holding
marketstring enum市场代码,目前只支持 US(美股)。
holdingTypestring enumdetail=机构持股明细、statistics=机构持股统计。
symbolstring证券代码,需带.US.us 后缀,例如 AAPL.US。
symbolsstring[]批量证券代码列表,需带.US.us 后缀,例如 ["BABA.US", "AAPL.us"]。

返回字段

holdingType=detailsymbol 证券代码、 holderName 股东名称、 holdingNumber 持股数、 holdingRatio 持股比例、 changeNumber 变动股数、 changeRatio 变动比例、 reportDate 发布日期。

holdingType=statisticssymbol 证券代码、 total 机构总数、 totalChange 机构总数较上期变动、 holdingNumber 持股数、 holdingNumberChange 持股数较上期变动、 holdingRatio 持股比例、 holdingRatioChange 持股比例较上期变动环比、 reportDate 报告日期、 neworgnum 新进机构数、 addedorgnum 增持机构数、 reduceorgnum 减持机构数、 price 股价。

使用示例

"有哪些机构持有 AAPL?最近机构是在加仓还是减仓?"


17. shareholding_fund_broker — 券商/沽空

券商持仓比例与排名、沽空(卖空)数据。覆盖港股和美股。基金持仓、基金成分、净值和业绩统一使用 fund_etf

输入参数

参数类型必填说明
endpointstringget_broker_holding / get_short_sell
paramsobject包含 holdingType (ratio/detail/statistics/rank/f10_ratio)、 symbol

使用示例

"00700.hk 的沽空比例是多少?" / "哪些券商席位持有腾讯?"


18. fund_etf — 基金与 ETF

全球基金搜索、基本资料、经理、分红、费率、净值、业绩、风险、完整持仓、资产/行业/国家配置、基准、销售市场、比较、排行、筛选与国家代码解析。基金按 fund_idfund_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_fundsscreen_funds 返回顶层 format/columns/columnNames/rows ,不再使用 semanticTool/data 包装。 columns[i]columnNames[i]rows[*][i] 严格按位置对应。

  • 保留实际返回的 meta (基金和份额标识、数据日期、估算标记、警告等)。
  • 保留 pagepage_sizehas_morenext_page ,接口提供 total 时也保留;不自动翻页。
  • 记录中的份额类别、币种、日期以及原始数值均保留,不跨份额、币种或日期汇总,不换算收益率、权重或币种;缺失值不填零。
  • 空列表保留表结构、元数据及分页。未知字段保留,并显式标注缺少中文名。
  • 最新净值、当前/前十大持仓及其余 endpoint 保持原有返回格式。

输入参数

参数类型必填说明
endpointstringsearch_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
paramsobject基金引用使用 fund_idfund_class_id ;分页使用 page (从 0 开始)和 page_size (最大 200);日期使用 start_date / end_date

使用示例

"搜索代码为 DRAM 的基金,并查询它的完整持仓" / "比较这几只基金的资料和近一年表现"


19. stock_connect — 沪深港通

北向/南向资金额度使用、净成交额、累计净流入、持股比例、成交排名、持股变动率排名、资金流向分布。覆盖港股通和陆股通双向数据。

输入参数

参数类型必填说明
endpointstringget_stock_connect_data / get_hk_stock_connect_data / get_cn_stock_connect_data
paramsobject包含 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 个端点。

输入参数

参数类型必填说明
endpointstringget_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
paramsobject包含 ipoType (calendar/make_new/today/to_be_listed/listed/offering/company_info/margin 等)、 symbolipoMarketTypecontentType

使用示例

"本周港股有哪些新股在招股?" / "帮我查一下某 IPO 的基石投资者和孖展情况"


21. bond_basic — 债券基础

债券搜索、债券概况、快照报价、订单簿。使用 market=GLOBAL 进行跨市场债券查询,证券代码可使用 ISIN 编码。

输入参数

参数类型必填说明
endpointstringsearch_bond / get_bond_profile / get_bond_quote / get_bond_orderbook
paramsobject包含 market (GLOBAL)、 symbol (支持 ISIN)、 keyword

使用示例

"帮我搜索某 ISIN 对应的债券基本信息" / "查看这只债券的实时报价"


22. bond_analytics — 债券分析

债券排名、债券图表(收益率曲线等)、债券收益率、债券交易状态。使用 market=GLOBAL ,提供债券市场的深度分析功能。

输入参数

参数类型必填说明
endpointstringget_bond_rankings / get_bond_chart / get_bond_yield / get_bond_trading_status
paramsobject包含 market (GLOBAL)、 symbolchartType

使用示例

"查看这只债券的收益率曲线" / "当前债券市场收益率排名"


23. fiu_news — 金融资讯

最新新闻、关键词搜索、语义搜索、个股相关新闻、新闻详情、关联新闻、新闻统计、新闻摘要。覆盖港股、美股、A股(中华通)、日股,支持标题/摘要/关键词搜索及语义级别的智能匹配,共 8 个端点。

输入参数

参数类型必填说明
endpointstringnews_latest / news_search / news_semantic_search / news_by_symbol / news_get / news_related / news_count / news_digest
paramsobject包含 market (HK/US/CN/JP/GLOBAL)、 query (搜索关键词)、 symbolidlimit (默认 10,最大 50)、 hours (默认 24,最大 168)等

使用示例

"最近 24 小时关于腾讯的新闻有哪些?" / "搜索港股市场关于 AI 的最新新闻"


24. financial_calendar — 财经日历

查询全球财经日历,支持按标题关键词、日期范围、国家/地区、市场、事件类型和重要等级筛选,并可按事件 ID 查询详情。覆盖经济数据发布、重要事件、权息和休市安排。

输入参数

参数类型必填说明
endpointstringsearch_financial_calendar / get_financial_event_detail
paramsobject搜索时 date (开始日期,YYYY-MM-DD)和 keyword (标题关键词)必填;可选 endDatedirection (-1=向未来,1=向历史)、 limitcountryTypeseventTypesmarketsimportanceLevels 。查询详情时传 id (搜索结果中的事件 ID)。

返回说明

搜索返回按日期组织的财经事件及事件 ID;详情接口返回单个事件的完整字段。未传 endDate 时使用 directionlimit 控制滚动日期窗口。

使用示例

"查询未来一周美国的重要经济数据" / "查看财经日历事件 ID 12345 的详情"


25. macro_economics — 宏观经济

查询精选宏观经济指标的最新数据,例如货币供应量、利率、通胀、就业、GDP、贸易和 PMI 等。

输入参数

参数类型必填说明
endpointstringget_macro_overview
titleIdinteger enum宏观指标标题 ID:10=央行资产负债表、20=M2 同比、30=LPR、40=PPI、50=城镇调查失业率、60=固定资产投资、70=社会消费品零售、80=GDP、90=贸易余额、100=CPI、110=制造业 PMI。

返回说明

返回指定 titleId 指标的最新数据,内容包含指标名称、发布时间、数值及同比/环比等可用字段。

使用示例

"查询中国 CPI 最新数据" / "获取当前精选宏观经济指标"


company_announcements — 上市公司公告

查询港股、美股和 A 股上市公司公告。公告记录包含附件地址或正文;附件获取失败时保留该条公告并标记附件状态。

输入参数

参数类型必填说明
endpointstring enumget_company_announcements。
marketstring enumHK / US / CN。
symbolsstring[]至少一个证券代码,例如 ["00700.hk"]。
startDatestring公告开始日期,YYYY-MM-DD。
endDatestring公告结束日期,YYYY-MM-DD。

调用示例

{"endpoint":"get_company_announcements","market":"HK","symbols":["00700.hk"]}

26. reference — 参考数据

ISIN/SEDOL/CIK 代码查询、货币代码、交易时段、除权日、退市记录、证券代码映射(股票/指数)、市场交易日历。覆盖港股、美股、A股(中华通)、日股,债券参考数据使用 market=GLOBAL ,共 4 个端点。

输入参数

参数类型必填说明
endpointstringget_reference_data / get_symbol_mapping / get_trading_status / get_market_hours
paramsobject包含 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 代码" / "今天港股是否交易日?交易时段是什么?"


接入配置

前置条件

  1. 访问 ai.szfiu.com 申请 API Key
  2. HTTP 直连需要支持 Streamable HTTP 协议的 MCP 客户端
  3. 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 协议