src/mcp_servers/
├── base.py                    # BaseMCPServer 基类，封装 FastMCP 初始化、工具/资源注册、运行入口
├── stock_market/              # A股行情数据服务
│   ├── data_fetcher.py        #   数据获取层（mootdx 封装、前复权、均线计算）
│   ├── service.py             #   服务层（MCP 工具注册）
│   └── main.py                #   启动入口
├── kph_market_data/           # 开盘红平台行情数据服务
│   ├── client.py              #   HTTP 客户端（封装开盘红 API 请求）
│   ├── models.py              #   数据模型（请求/响应 Pydantic 模型）
│   ├── stock_tags.py          #   个股标签查询
│   ├── config.py              #   配置管理
│   ├── logger.py              #   日志配置
│   ├── service.py             #   服务层（MCP 工具注册、数据格式化）
│   └── main.py                #   启动入口
└── star_stocks/               # 题材个股管理服务
    ├── config.py              #   环境变量初始化
    ├── db.py                  #   数据库会话管理
    ├── helpers.py             #   通用工具函数
    ├── service.py             #   服务层（MCP 工具注册、CRUD 操作）
    └── main.py                #   启动入口

mcpServers/
├── src/mcp_servers/           # 服务源码
├── tests/                     # 测试文件
│   ├── test_stock_market.py
│   ├── test_kph_market_data.py
│   ├── test_star_stocks_mcp.py
│   └── test_data_fetcher.py
├── examples/                  # 使用示例
│   ├── stock_market_example.py
│   ├── kph_market_data_example.py
│   └── kph_market_data_client_example.py
├── docs/                      # 架构文档
├── start_stock_market_service.py      # A股行情服务启动脚本
├── start_kph_market_data_service.py   # 开盘红服务启动脚本
├── start_star_stocks_service.py       # 题材个股服务启动脚本
├── mcp_config.json            # MCP 客户端配置参考
├── pyproject.toml             # 项目元数据与依赖
└── uv.lock                    # 依赖锁文件

# 格式化
black src tests examples

# 代码检查
flake8 src tests examples

# 类型检查
mypy src

pytest tests/ -v