A Model Context Protocol (MCP) server for accessing Futu OpenAPI functionality
Wellknown found it in public sources; nobody has proven control of it yet. Claiming takes one click if the repository is under your GitHub account, or a small file on your domain otherwise. Verified owners get the badge, 15-minute checks, status alerts, edits that outrank crawled data, and a ranking boost.
Agents can do it too: POST https://wellknown.network/api/v1/claims with {"agent":"futu-stock-mcp-server","method":"well_known_file"} — machine-readable steps at claim.json, guide at /docs/claim.
Everything here was measured by our prober or read from a registry. Nothing is self-reported.
Attributed to the source that supplied each field. Treated as claims, not facts.
# Futu Stock MCP Server [](https://www.python.org) [](LICENSE) [](https://openapi.futunn.com/futu-api-doc/) 基于[模型上下文协议(MCP)](https://github.com/cursor-ai/model-context-protocol)的富途证券行情交易接口服务器。将富途OpenAPI功能以标准化的MCP协议提供给AI模型使用，支持行情订阅、数据查询等功能。 ## 🌟 特性 - 🔌 完全兼容 MCP 2.0 协议标准 - 📊 支持港股、美股、A股等市场的实时行情 - 🔄 支持实时数据订阅和推送 - 📈 支持K线、逐笔、买卖盘等多维度数据 - 🔒 安全的API调用和数据访问机制 - 🛠 提供完整的开发工具和示例代码 ## ⚠️ 前置要求 在使用本项目之前，您需要： 1. 拥有富途证券账户并开通OpenAPI权限 2. 安装并运行富途的OpenD网关程序（[官方文档](https://openapi.futunn.com/futu-api-doc/intro/intro.html)） 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 安装（推荐） ```bash # 安装 pipx（如果还没有安装） brew install pipx # macOS # 或者 pip install --user pipx # 其他系统 # 安装包 pipx install futu-stock-mcp-server # 运行服务器 futu-mcp-server ``` > **为什么使用 pipx？** > - pipx 专门用于安装 Python 应用程序到全局环境 > - 自动管理独立的虚拟环境，避免依赖冲突 > - 命令直接可用，无需激活虚拟环境 ### 方式二：通过 Docker 运行 ```bash # 拉取镜像 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: ```bash git clone https://github.com/yourusername/futu-stock-mcp-server…
Mapped onto the structured taxonomy from declared text and observed tool names. Confidence shown for derived entries.
Every source is kept verbatim. Field changes are logged as events.