mcp_law_server/
├── pyproject.toml            # 元数据 / 依赖 / 入口 / 工具配置
├── .env.example              # 环境变量模板（复制为 .env 填写）
├── Makefile                  # 常用命令封装
├── src/mcp_law_server/       # ── 应用代码（src-layout，可 pip install -e .）──
│   ├── main.py               # 入口
│   ├── config/               # 配置层（无内部依赖）—— settings 单例
│   ├── models/               # 数据模型层（仅依赖 config）—— enums / schemas / errors
│   ├── db/                   # MySQL 数据访问层 —— connection + 4 个 DAO
│   ├── vector/               # Milvus 向量访问层 —— client + 3 个 search
│   ├── embedding/            # Embedding 服务层 —— bge_embedder
│   ├── cache/                # 缓存层 —— registry_cache
│   ├── tools/                # MCP 工具层 —— 9 个 tool handler（核心业务）
│   └── server/               # MCP Server 注册与启动 —— mcp_app
├── hermes/                   # ── Hermes 编排（平台侧，YAML + prompts，非 Python）──
├── scripts/                  # ── 运维脚本（向量化入库 / 阈值校准 / 数据探查）──
└── tests/                    # ── 测试（db / vector / tools / integration）──

# 1. 安装核心 + 开发依赖（uv 会自动准备 Python 3.12 解释器）
uv sync

# 2. （按需）安装 ML 依赖（FlagEmbedding / torch，体积较大）
uv sync --extra ml

# 3. 配置环境变量
cp .env.example .env          # 然后编辑 .env 填写真实值

# 4. 启动 MCP HTTP server
uv run mcp-law-server         # 等价：make run