金融数据查询平台

┌─────────────┐     ┌──────────────┐     ┌───────────────┐     ┌───────────────┐
│  React UI   │────▶│ Express API  │────▶│ Python Bridge │────▶│ Wind Terminal │
│  :5173      │     │ :3001        │     │ wind_bridge.py│     │ (WindPy)      │
└─────────────┘     └──────────────┘     └───────────────┘     └───────────────┘
                           │
┌─────────────┐            │
│  LLM Client │────────────┘  (MCP stdio transport via index.js)
│  (Claude等) │
└─────────────┘

npm install
pip install openpyxl
npm run build

# 启动后端 API 服务
npm run server

# 启动前端开发服务
npm run dev:ui

# 启动 MCP Server（stdio，供 LLM 客户端使用）
npm start

{
  "mcpServers": {
    "wind": {
      "command": "node",
      "args": ["C:/Users/Pixel/Projects/wind-mcp-server/dist/index.js"]
    }
  }
}

src/
├── index.ts                 MCP Server 入口（stdio transport）
├── server.ts                Express API 服务（HTTP :3001）
├── bridge/
│   ├── runner.ts            Python 子进程调用
│   └── types.ts             请求/响应类型定义
├── python/
│   ├── wind_bridge.py       CLI 分发器：解析 JSON → 路由到 handler
│   ├── excel_reader.py      Excel 文件读取（openpyxl）
│   ├── utils.py             WindData 序列化、错误码映射、结果合并
│   └── handlers/
│       ├── wsd.py           日期序列（多codes+多fields自动拆分）
│       ├── wss.py           日截面
│       ├── wsq.py           实时行情
│       ├── wst.py           日内Tick
│       ├── wset.py          数据集报表
│       ├── wses.py          板块日序列
│       ├── wsee.py          板块日截面
│       ├── edb.py           宏观经济
│       ├── tdays.py         交易日历
│       ├── tdaysoffset.py   日期偏移
│       └── tdayscount.py    交易日计数
└── ui/                      React 前端
    ├── App.tsx              主页面（查询/ETL/清洗/设置 四个 Tab）
    ├── api/client.ts        API 客户端（支持 JSON 和 FormData 上传）
    ├── config/
    │   ├── windFunctions.ts Wind 函数配置（字段、提示、校验规则）
    │   └── llmConfig.ts     LLM Provider 配置
    ├── components/          表单、结果表格、状态指示器等
    └── pages/               ETL、数据清洗、LLM 设置页面

db/                          PostgreSQL DDL
etl/                         数据入库脚本
docus/                       Wind API 文档
testdata/                    测试用 Excel 文件
config/                      LLM 密钥配置（已 gitignore）

# 测试 Python Bridge（需要 Wind 终端运行）
python src/python/wind_bridge.py '{"function":"tdays","params":{"beginTime":"2025-01-01","endTime":"2025-01-31"}}'

# 测试 Excel 导入
python src/python/wind_bridge.py '{"function":"wsd","params":{"fields":"close","excelPath":"testdata/sample_codes.xlsx"}}'