Crate futu_mcp 

FutuOpenD-rs MCP 服务器

通过 Model Context Protocol 把 Futu 行情/账户能力暴露给 Claude / LLM 客户端。

授权有两种模式：

• Scope 模式：--keys-file <path> 启用，客户端必须通过 FUTU_MCP_API_KEY 环境变量传入明文 key。服务器用 SHA-256 hash 比对 keys.json 中的记录， 按 scope + 限额放行。
• Legacy 模式：未提供 keys-file 时回退到旧的 --enable-trading / --allow-real-trading 两级开关。

Modules

guard 🔒

Scope 守卫 + 限额检查 + 审计日志

handlers 🔒

工具实现（按域拆分）

state 🔒

共享状态：网关连接 + 订阅状态 + 授权

tools 🔒

MCP 工具定义（#[tool] 薄封装，业务逻辑在 handlers/）

Structs

Cli 🔒

FutuOpenD-rs MCP server

Functions

main 🔒

serve_http 🔒

HTTP 模式：axum + rmcp StreamableHttpService，/mcp 路径跑 MCP， /metrics 暴露 Prometheus counters（无需 token）。

serve_stdio 🔒

stdio 模式：MCP 客户端启动子进程，stdin/stdout 传协议帧

setup_logging 🔒

初始化 stderr 日志 + 可选 audit JSONL 层

spawn_sighup_reload 🔒