tradex-hub

AI金融智能决策中台
AKShare 封装 · eltdx 通达信协议 · astock_signals 信号模块 · 量化计算引擎 · SmartRouter 全量路由 · 本地 MCP Server · 99 个工具

为 AI Agent（WorkBuddy / Claude Code / Cursor）提供 A 股金融数据 + 量化计算 + 决策支持的 MCP 接口。

三层能力模型：

• L1 数据获取层（65个工具）：通过 SmartRouter 统一获取数据（行情/财务/估值/行业/新闻/宏观/涨停板/龙虎榜等）
• L2 计算引擎层（8个工具）：技术指标计算6个、绩效指标计算2个
• L3 决策支持层（16个工具）：交易信号生成3个、多因子分析2个、条件选股2个、系统诊断5个、综合分析3个、技术分析引擎1个

数据源架构（v3.3.0）：

• data_sources 数据源层：38 个数据类型，48 个数据源注册到 SmartRouter
• SmartRouter 全量覆盖：L1 工具通过 SmartRouter.route() 统一获取数据，自动健康评分/降级/故障隔离
• 独占源标记：集合竞价/逐笔/F10（eltdx 独有）、涨停归因（同花顺独有）、解禁日历（东财独有）等标记为 exclusive
• eltdx 1.2.0：行情类第一主源（郑州节点，TCP 3.5ms），独有集合竞价/逐笔/F10
• 新闻资讯数据源：东财个股新闻直连、财联社实时电报、巨潮公告直连、新浪财经直连、百度经济日历/交易提醒/热搜、期货新闻、东财人气榜、雪球热度、机构持仓、同花顺问财等
• 数据源看板：python -m tradex.dashboard（端口 8765），可视化查看数据源健康/路由/工具分布；MCP 工具 get_data_source_dashboard 可在 Agent 对话中查询

v3.3.0 更新：新增 9 个 akshare 新闻资讯数据源（百度/东财人气/雪球/期货/基金持仓等）+ 同花顺问财可选集成，新增 9 个 MCP 工具（工具数 90→99），数据类型从 27 扩展到 38。详见 docs/architecture.md。

AI Agent (WorkBuddy / Claude Code / Cursor)
        │  MCP 协议 (stdio)
        ▼
  tradex ── FastMCP Server
        │
        ├── AKShare 封装（43 工具）
        │     ├── company_info (4)   → 搜索/概况/竞品
        │     ├── price_data (5)     → 实时行情/历史K线/分时/市值/列表
        │     ├── financial_stmt (8) → 三表+财务指标+增长率+每股+分拆营收
        │     ├── valuation (4)      → PE/PB/PS历史/分红/机构持仓/分析师评级
        │     ├── industry (5)       → 行业板块/成分股/概念/板块资金流/行业PE
        │     ├── market (5)         → 指数快照/资金流/北向/涨跌停/龙虎榜
        │     ├── news_events (4)    → 个股新闻/财报日历/公告/关键词搜索
        │     └── macro_fx (8)       → GDP/CPI/PMI/M2/汇率/国债/两融/增减持
        │
        ├── 信号数据 — 混合数据源（17 工具）
        │     ├── signal_data (17)   → 涨停归因/解禁/概念/预期/技术指标/北向/资金流/龙虎榜/行业/ETF/可转债/涨停板
        │     └─ 数据源：东财直连 + 同花顺 + AKShare
        │
        └── eltdx 1.2.0 封装（5 工具）
              ├── 集合竞价 (auction)    — AKShare 无此功能
              ├── 逐笔成交 (ticks)      — AKShare 无此功能
              ├── F10 资料 (f10)        — AKShare 无此功能
              ├── 分时数据 (minutes)    — 与 AKShare 互补
              └── K 线 (kline)          — 与 AKShare 互补
                    └─ 数据源：通达信私有协议 (TCP 7709)

纯函数实现，输入价格数组，输出与 Excel/通达信一致的指标值。

系统自省与运维诊断工具，不依赖外部数据源。

组合调用 L1 数据 + L2 计算结果，输出多维度综合分析报告。

git clone https://github.com/wolfjkd/tradex-hub.git
cd tradex-hub

python -m venv venv
source venv/bin/activate  # Linux/Mac
# 或 venv\Scripts\activate  # Windows

astock_signals 已从 tradex-hub 独立成包，需先安装：

pip install -e astock_signals/

或从 GitHub 克隆：git clone https://github.com/wolfjkd/astock_signals.git && pip install -e astock_signals/

cd tradex
pip install hatchling editables
pip install --no-build-isolation -e .

pip install "akshare>=1.18.81" mcp pandas pydantic "eltdx>=1.2.0"

编辑 MCP 配置文件（如 ~/.trae-cn/mcp.json 或对应 AI Agent 的配置文件）：

{
  "mcpServers": {
    "tradex": {
      "command": "/path/to/venv/Scripts/python.exe",
      "args": ["-m", "tradex"],
      "env": {}
    }
  }
}

保存后重启 AI Agent，连接器页面 tradex 应显示绿色。

重启后在对话里测试：

查中国能建（601868）K线

AI 会调用 mcp__tradex__eltdx_get_kline，返回 100 根日 K 线。

1. eltdx 逐笔数据不带时间字段（time: null），只有价格/量/方向
2. eltdx F10 延迟高（~2 秒），但数据独有（题材归因是 AKShare 没有的）
3. SmartRouter 全量覆盖（v3.1.0）：L1 工具通过 SmartRouter.route() 统一获取数据，自动健康评分/降级/故障隔离，25 数据类型 34 源
4. Wind/通达信 MCP 不在本项目里：通过独立 MCP Server 或 AI Agent 的 connector 系统接入

Apache-2.0 License

郭良勇 (wolfjkd) — A股T0日内交易员