项目介绍
@shuchang/futu-mcp-server
Futu API MCP服务器 - 完整的股票数据和交易功能MCP工具集
快速开始
推荐直接使用npx运行：
npx @shuchang/futu-mcp-server
或者全局安装：
npm install -g @shuchang/futu-mcp-server
futu-mcp
环境变量配置
你可以通过环境变量来配置Futu API连接参数：
FUTU_API_HOST：Futu API主机地址（默认：127.0.0.1）FUTU_API_PORT：Futu 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虚拟环境
- 自动安装所需依赖项
- 支持环境变量配置
- 完整的Futu API功能支持
- 集成MCP协议
系统需求
- Node.js >= 14.0.0
- Python 3.x
- Futu牛牛客户端
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 市场访问
- 基本市场条件：所有用户均可使用
- 二级市场数据：需要开启相应市场的二级市场数据权限
- 期权市场数据：需要市场访问权限
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
- 增加止盈止损功能
- 优化数据推送机制
- 增加更多技术指标支持