Trader Finance Hub

AI金融数据聚合平台
AKShare 封装 · eltdx 通达信协议 · astock_signals 信号模块 · 本地 MCP Server · 61 个工具

项目定位

为 AI Agent（WorkBuddy / Claude Code / Cursor）提供 A 股金融数据的 MCP 接口。

当前数据源：

• AKShare：56 个金融工具（42 个基础工具 + 14 个信号数据中的 AKShare 部分）
• eltdx 1.0.2：5 个通达信独有工具（集合竞价/逐笔/F10/分时/K线）
• 东财/同花顺直连：6 个信号工具（涨停归因/一致预期/北向资金/个股资金流/龙虎榜/行业对比）

不吹牛：这不是"多源智能路由"，就是两个数据源的 MCP 壳。
多源聚合是规划目标，代码里还没实现。

项目架构

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

MCP 工具清单（61 个）

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

2. 行情数据（4 个）— 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股信号+品种（15 个）— signal_data

10. eltdx 通达信独有（5 个）— eltdx_data

安装

1. 克隆项目

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

2. 创建独立 venv（推荐）

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

3. 安装 cn-financial-mcp

cd cn-financial-mcp
pip install hatchling editables
pip install --no-build-isolation -e .

4. 安装运行时依赖

pip install akshare mcp pandas pydantic eltdx

配置到 WorkBuddy

编辑 ~/.workbuddy/mcp.json：

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

保存后重启 WorkBuddy，连接器页面 cn-financial-mcp 应显示绿色。

验证

重启后在对话里测试：

查中国能建（601868）K线

AI 会调用 mcp__cn-financial-mcp__eltdx_get_kline，返回 100 根日 K 线。

已知限制

1. eltdx 逐笔数据不带时间字段（time: null），只有价格/量/方向
2. eltdx F10 延迟高（~2 秒），但数据独有（题材归因是 AKShare 没有的）
3. 没有智能路由：每个工具写死一个数据源，不会自动择优
4. Wind/通达信 MCP 不在本项目里：通过 WorkBuddy connector/skill 系统接入

版本历史

许可

Apache-2.0 License

作者

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