tradex-hub

项目定位

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

三层能力模型（127 个工具）：

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

数据源架构（v3.3.8）：

• data_sources 数据源层：65 个数据类型，76 个数据源注册到 SmartRouter
• SmartRouter 全量覆盖：L1 工具通过 SmartRouter.route() 统一获取数据，自动健康评分/降级/故障隔离
• eltdx 2.0.2：行情类第一主源，31 个工具覆盖五档盘口/集合竞价/逐笔/F10/分时/K线/全景档案/短线指标/题材/分类行情等；新增常驻连接管理器 eltdx_stream.py（游标增量轮询实现准实时五档盘口）
• 新闻资讯数据源：东财个股新闻直连、财联社实时电报、巨潮公告直连、新浪财经直连、百度经济日历/交易提醒/热搜、期货新闻、东财人气榜、雪球热度、机构持仓、同花顺问财等
• 数据源看板：python -m tradex.dashboard（端口 8765），可视化查看数据源健康/路由/工具分布；MCP 工具 get_data_source_dashboard 可在 Agent 对话中查询

v3.3.8 更新：eltdx 2.0 能力大规模接入（S+A+B 三梯队共 26 个新工具：五档盘口/历史分时/买卖强度/逐笔/开盘撮合/全量K线/复权K线/全景档案/短线指标/批量财务/F10财报分红资讯北向/题材/竞价/分类行情/交易日/股本变动/特殊涨跌停扫描），工具数 101→127，数据类型 40→65。

项目架构

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 2.0.2 封装（31 工具）
              ├── 五档盘口 (depth)        — 常驻连接 + 游标增量轮询
              ├── 集合竞价 (auction)      — AKShare 无此功能
              ├── 逐笔成交 (ticks)        — AKShare 无此功能
              ├── F10 资料 (f10)          — AKShare 无此功能
              ├── 分时数据 (minutes)      — 含历史分时 + 买卖强度
              ├── K 线 (kline)            — 含全量 + 复权
              ├── 全景档案 (profile)      — 行情+财务一表
              ├── 短线指标 (shortline)    — 21 项打板指标
              ├── 批量财务 (finance)      — 总股本/资产/净利润
              ├── 题材 (topics)           — 个股题材 + 成分股
              └── 分类行情 (category)     — 涨幅榜/成交额榜
                    └─ 数据源：通达信私有协议 (TCP 7709)

MCP 工具清单（127 个）

1. 公司信息（4 个）— company_info

2. 行情数据（5 个）— price_data

3. 财务报表（8 个）— financial_stmt

4. 估值分析（4 个）— valuation

5. 行业板块（5 个）— industry

6. 市场总览（5 个）— market

7. 新闻公告（4 个）— news_events

8. 宏观衍生（8 个）— macro_fx

9. A股信号+品种（17 个）— signal_data

10. eltdx 通达信协议（31 个）— eltdx_data 🆕 v3.3.8 扩充

盘口/推送（S 级，交易看板底座）：

集合竞价/逐笔：

分时：

K 线：

F10/基本面：

题材/分类：

11. 技术指标计算（6 个）— technical_indicators 🆕 V2.5.0

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

12. 绩效指标计算（2 个）— performance_metrics 🆕 V2.5.0

13. 信号生成（3 个）— signal_generation 🆕 V2.5.0

14. 因子分析（2 个）— factor_analysis 🆕 V2.5.0

15. 条件选股（2 个）— stock_screening 🆕 V2.5.0

16. 系统诊断（5 个）— diagnostics 🆕 v3.0.0

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

17. 综合分析（3 个）— composite_analysis 🆕 v3.0.0

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

18. 技术分析引擎（1 个）— analysis_engine 🆕 v3.0.0

安装

1. 克隆项目

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

2. 创建独立 venv（推荐）

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

3. 安装 astock_signals 独立包（v1.1.0）

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

pip install -e astock_signals/

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

4. 安装 tradex

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

5. 安装运行时依赖

pip install "akshare>=1.18.91" mcp pandas pydantic "eltdx>=2.0.2"

配置到 AI Agent

编辑 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 F10 字段为通达信内部编码（T007/T008 等）：财报/分红/资讯/北向 4 个接口返回原始编码字段，作为 akshare 中文源的降级补充源，字段中文映射留待后续
2. 免费行情站不主动推送：eltdx drain_pushes 实测 0 帧，「推送」实为 refresh_stream 游标增量轮询（eltdx_stream.py 已封装）
3. eltdx F10 延迟较高（~2 秒）：走 7615 HTTP 网关，但数据独有（题材归因 AKShare 没有）
4. SmartRouter 全量覆盖：L1 工具通过 SmartRouter.route() 统一获取数据，自动健康评分/降级/故障隔离，65 数据类型 76 源
5. Wind 等独立 MCP 不在本项目里：通过独立 MCP Server 或 AI Agent 的 connector 系统接入

版本历史

许可

Apache-2.0 License

作者

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