返回 MCP 目录
public公开dns本地运行

futu-stocp-mcp-server

基于模型上下文协议(MCP)的富途证券行情交易接口服务器,提供标准化的MCP协议访问富途OpenAPI功能,支持行情订阅、数据查询等。

article

README

🚀 Futu 未来函数

Futu 未来函数提供了丰富的金融数据获取、账户管理、实时数据订阅以及期权相关功能,助力用户高效开展金融业务操作。

🚀 快速开始

本项目提供了一系列金融数据获取和操作的工具函数,可通过异步调用 session.call_tool 方法来使用这些功能。

✨ 主要特性

  • 数据获取:支持获取股票列表、证券信息、市场状态等多种金融数据。
  • 账户功能:可获取账户列表、资金、持仓、最大交易权限等账户相关信息。
  • 时间功能:能获取服务器当前时间。
  • 订阅与取消订阅:支持订阅和取消订阅指定证券的实时数据。
  • 期权功能:提供获取期权链、期权到期日和期权 Condor 策略数据的功能。

💻 使用示例

基础用法

数据获取

  • 获取股票列表
result = await session.call_tool("get_security_list", {"market": "HK"})
  • 获取证券信息
result = await session.call_tool("get_security_info", {
    "market": "HK",
    "code": "00700"
})
  • 获取市场状态
result = await session.call_tool("get_market_state", {"market": "HK"})

支持的市场: "HK", "US", "SH", "SZ"

账户功能

  • 获取账户列表
result = await session.call_tool("get_account_list", {"random_string": "dummy"})
  • 获取账户资金
result = await session.call_tool("get_funds", {"random_string": "dummy"})
  • 获取账户持仓
result = await session.call_tool("get_positions", {"random_string": "dummy"})
  • 获取最大交易权限
result = await session.call_tool("get_max_power", {"random_string": "dummy"})
  • 获取 Margin Ratio
result = await session.call_tool("get_margin_ratio", {"symbol": "HK.00700"})

时间功能

  • 获取当前时间
result = await session.call_tool("get_current_time", {"random_string": "dummy"})

返回格式包括: 带时间戳的时间字符串, 格式化日期时间, 日期和时间。

订阅与取消订阅

  • 订阅实时数据
result = await session.call_tool("subscribe", {
    "symbols": ["HK.00700", "US.AAPL"],
    "sub_types": ["QUOTE", "TICKER", "K_1M"]
})

支持订阅类型:

  • "QUOTE": 基础行情

  • "ORDER_BOOK": 订单簿

  • "TICKER": 成交数据

  • "RT_DATA": 实时数据

  • "BROKER": 经纪队列

  • "K_1M" 到 "K_MON": K 线数据

  • 取消订阅实时数据

result = await session.call_tool("unsubscribe", {
    "symbols": ["HK.00700", "US.AAPL"],
    "sub_types": ["QUOTE", "TICKER"]
})

期权功能

  • 获取期权链
result = await session.call_tool("get_option_chain", {
    "symbol": "HK.00700",
    "start": "2024-04-01",
    "end": "2024-06-30"
})
  • 获取期权到期日
result = await session.call_tool("get_option_expiration_date", {
    "symbol": "HK.00700"
})
  • 获取期权 Condor 策略数据
result = await session.call_tool("get_option_condor_strategy", {
    "symbol": "HK.00700",
    "start": "2024-04-01",
    "end": "2024-06-30"
})
help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端