富途 MCP 服务器 (Futu MCP Server)

@shuchang/futu-mcp-server

富途API MCP服务器 - 完整的股票数据和交易功能MCP工具集

快速开始

使用 npx 直接运行（推荐）：

npx @shuchang/futu-mcp-server

或者全局安装：

npm install -g @shuchang/futu-mcp-server
futu-mcp

环境变量配置

可以通过环境变量配置富途API连接参数：

FUTU_API_HOST: 富途API主机地址（默认：127.0.0.1）
FUTU_API_PORT: 富途API端口（默认：11111）
FUTU_UNLOCK_PASSWORD: 交易解锁密码（可选）

示例：

export FUTU_API_HOST=192.168.1.100
export FUTU_API_PORT=12345
export FUTU_UNLOCK_PASSWORD=your_password
npx @shuchang/futu-mcp-server

功能特点

自动设置Python虚拟环境
自动安装所需依赖
支持环境变量配置
完整的富途API功能支持
MCP协议集成

系统要求

Node.js >= 14.0.0
Python 3.x
富途牛牛客户端

Futu MCP 使用指南

1. 功能介绍

1.1 行情查询

获取实时报价和盘口数据
查看K线数据（支持分钟、日、周、月K线）
获取股票快照数据（价格、成交量、市值等）
条件选股功能（支持财务指标、技术指标筛选）

1.2 交易功能

查看持仓信息
查看账户资金
股票交易（买入/卖出）
订单管理（改单/撤单）

1.3 自选股管理

获取自选股列表
查看自选股分组
管理自选股分组

2. 配置说明

2.1 环境要求

需要安装并运行 Futu OpenD
需要有效的 Futu 账户
需要相应的 API 权限

2.2 权限配置

登录 Futu 账户
打开 Futu OpenD
配置 API 权限：
- 行情权限
- 交易权限（如需要）
- 自选股权限

2.3 接口配置

// 示例配置
{
    "FutuOpenD": {
        "Host": "localhost",
        "Port": 11111,
        "EnableEncrypt": true
    },
    "Market": ["HK", "US", "CN"],
    "Language": "zh-CN"
}

3. 权限说明

3.1 行情权限

基础行情：所有用户均可使用
Level 2 行情：需要开通相应市场的 Level 2 行情权限
期权行情：需要开通期权市场权限

3.2 交易权限

查询权限：可查看持仓、资金等信息
交易权限：可进行买入、卖出等操作
需要在 Futu OpenD 中配置相应的交易密码和权限

3.3 自选股权限

读取权限：可查看自选股列表和分组
修改权限：可修改自选股分组和内容

4. 新增功能

4.1 条件选股增强

新增技术指标筛选
支持多个条件组合
支持自定义筛选条件保存

4.2 交易功能优化

支持条件单
支持止盈止损设置
订单状态实时推送

4.3 数据分析功能

K线数据分析
成交量分析
技术指标计算

4.4 使用示例

// 获取持仓信息
positions, err := client.GetPositions(ctx, &futu.GetPositionsRequest{
    AccountType: futu.AccountType_REAL
})

// 获取账户资金
funds, err := client.GetFunds(ctx, &futu.GetFundsRequest{
    TrdEnv: futu.TrdEnv_REAL
})

// 条件选股示例
filter, err := client.GetStockFilter(ctx, &futu.GetStockFilterRequest{
    Market: "HK",
    FilterList: []futu.StockFilter{
        {
            FieldName: "VOLUME",
            FilterMin: 1000000,
            FilterMax: 10000000,
        },
    },
})

注意事项

请确保 Futu OpenD 正常运行
使用交易功能前请仔细确认账户和权限设置
注意遵守各市场的交易规则和时间
建议在进行实盘交易前先使用模拟交易测试
请妥善保管账户密码和交易密码

常见问题

无法连接 Futu OpenD
- 检查 OpenD 是否正常运行
- 检查网络连接
- 确认配置信息是否正确
交易权限相关
- 确认是否配置交易密码
- 检查是否有相应市场的交易权限
- 确认账户状态是否正常
行情数据延迟
- 检查网络连接质量
- 确认是否订阅了相应的行情权限
- 检查 OpenD 的性能状态

更新日志

v1.0.0

基础功能实现
支持行情查询
支持基础交易功能

v1.1.0

新增条件选股功能
优化交易接口
添加数据分析功能

v1.2.0

新增止盈止损功能
优化数据推送机制
增加更多技术指标支持

This server cannot be installed

security - not tested

license - not found

quality - not tested

How are these scores calculated?

hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Exposes Futu API client capabilities as an MCP (Model Context Protocol) tool, allowing AI assistants to access stock data from Futu through a standardized interface.

Related MCP Servers

Financial Datasets MCP Serverofficial
financial-datasets
-
security
A
license
-
quality
MCP server that provides AI assistants access to stock market data including financial statements, stock prices, and market news through a Model Context Protocol interface.
Last updated -
322
Python
MIT License
Trading Simulator MCP Server
recallnet
-
security
F
license
-
quality
An MCP server that enables AI models like Claude to interact with the Trading Simulator API for checking balances, viewing prices, and executing trades with automatic chain detection.
Last updated -
TypeScript
mcp-server-shioajiofficial
Sinotrade
-
security
F
license
-
quality
A Model Context Protocol (MCP) server that provides AI assistants with access to Shioaji trading API for the Taiwanese financial market.
Last updated -
1
Python
Financial Modeling Prep MCP Server
shadi-fsai
-
security
A
license
-
quality
A Model Context Protocol server that enables AI assistants like Claude to programmatically access financial data from Financial Modeling Prep API, including company profiles, financial statements, metrics, SEC filings, and market data.
Last updated -
5
Python
MIT License

View all related MCP servers