Futu Stock MCP Server

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

🌟 特性

• 🔌 完全兼容 MCP 2.0 协议标准
• 📊 支持港股、美股、A股等市场的实时行情
• 🔄 支持实时数据订阅和推送
• 📈 支持K线、逐笔、买卖盘等多维度数据
• 🔒 安全的API调用和数据访问机制
• 🛠 提供完整的开发工具和示例代码

⚠️ 前置要求

在使用本项目之前，您需要：

1. 拥有富途证券账户并开通OpenAPI权限
2. 安装并运行富途的OpenD网关程序（官方文档）
3. 根据您的需求订阅相应的行情权限

🔒 安全提示

• 请勿在代码中硬编码任何账号密码信息
• 确保.env文件已添加到.gitignore中
• 妥善保管您的API访问凭证
• 遵守富途OpenAPI的使用条款和限制

📝 免责声明

本项目是一个开源工具，旨在简化富途OpenAPI的接入流程。使用本项目时请注意：

1. 遵守相关法律法规和富途OpenAPI的使用条款
2. 自行承担使用本项目进行交易的风险
3. 本项目不提供任何投资建议
4. 使用本项目前请确保您已获得所需的行情权限

Features

• Standard MCP 2.0 protocol compliance
• Comprehensive Futu API coverage
• Real-time data subscription support
• Market data access
• Derivatives information
• Account query capabilities
• Resource-based data access
• Interactive prompts for analysis

Prerequisites

• Python 3.10+
• Futu OpenAPI SDK
• Model Context Protocol SDK
• uv (recommended)

🚀 快速开始

方式一：通过 pipx 安装（推荐）

# 安装 pipx（如果还没有安装）
brew install pipx  # macOS
# 或者 pip install --user pipx  # 其他系统

# 安装包
pipx install futu-stock-mcp-server

# 运行服务器
futu-mcp-server

为什么使用 pipx？

• pipx 专门用于安装 Python 应用程序到全局环境
• 自动管理独立的虚拟环境，避免依赖冲突
• 命令直接可用，无需激活虚拟环境

方式二：通过 Docker 运行

# 拉取镜像
docker pull your-registry/futu-stock-mcp-server:latest

# 运行容器
docker run -d \
  --name futu-mcp-server \
  -p 8000:8000 \
  -e FUTU_HOST=127.0.0.1 \
  -e FUTU_PORT=11111 \
  your-registry/futu-stock-mcp-server:latest

方式三：从源码安装

1. Clone the repository:

git clone https://github.com/yourusername/futu-stock-mcp-server.git
cd futu-stock-mcp-server

2. Install uv:

# macOS/Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows (PowerShell)
powershell -c "irm https://astral.sh/uv/install.ps1 | iex"

3. Create and activate a virtual environment:

# Create virtual environment
uv venv

# Activate virtual environment
# On macOS/Linux:
source .venv/bin/activate
# On Windows:
.venv\Scripts\activate

4. Install dependencies:

# Install in editable mode
uv pip install -e .

5. (可选) 如需从源码直接运行，通过环境变量配置服务：

export FUTU_HOST=127.0.0.1
export FUTU_PORT=11111

推荐方式：在 MCP 客户端配置文件中使用 env 字段注入，无需创建 .env 文件，见下方 MCP Server 配置 章节。

Development

Managing Dependencies

Add new dependencies to pyproject.toml:

[project]
dependencies = [
    # ... existing dependencies ...
    "new-package>=1.0.0",
]

Then update your environment:

uv pip install -e .

Code Style

This project uses Ruff for code linting and formatting. The configuration is in pyproject.toml:

[tool.ruff]
line-length = 100
target-version = "py38"

[tool.ruff.lint]
select = ["E", "F", "I", "N", "W", "B", "UP"]

Run linting:

uv pip install ruff
ruff check .

Run formatting:

ruff format .

🔧 MCP Server 配置

在 Claude Desktop 中配置

1. 找到配置文件位置：

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json

2. 添加服务器配置（所有参数均通过 env 字段注入，无需 .env 文件）：

{
  "mcpServers": {
    "futu-stock": {
      "command": "futu-mcp-server",
      "env": {
        "FUTU_HOST": "127.0.0.1",
        "FUTU_PORT": "11111",
        "FUTU_ENABLE_POSITIONS": "1",
        "FUTU_ENABLE_TRADING": "0",
        "FUTU_TRADE_ENV": "SIMULATE",
        "FUTU_SECURITY_FIRM": "FUTUSECURITIES",
        "FUTU_TRD_MARKET": "HK"
      }
    }
  }
}

3. 使用 python 命令启动（适用于源码开发场景）：

{
  "mcpServers": {
    "

... [View full README on GitHub](https://github.com/shuizhengqi1/futu-stock-mcp-server#readme)