┌─────────────────────────┐
│  SQL Agent (sql_agent)  │   自然语言问题
│  LLM function calling   │─────────┐
└─────────────┬───────────┘         │
              │ ① 发现工具 (list_tools) + schema
              │ ② 调用工具 (call_tool)
┌─────────────▼───────────┐
│  MySQL MCP Server       │  mcp_server.py（mcp 2.x MCPServer，stdio）
│  list_tables            │   工具动态注册，可换传输(sse/http)
│  get_schema             │
│  run_query (只读SELECT) │
└─────────────┬───────────┘
              │ ③ 连接
┌─────────────▼───────────┐
│  MySQL sales_demo       │  独立业务库：company / sale_records
└─────────────────────────┘

# Python 3.12+
python -m venv .venv
.venv\Scripts\activate        # Windows；macOS/Linux: source .venv/bin/activate
pip install -r requirements.txt

cp .env.example .env          # 然后编辑 .env 填入数据库密码 与 LLM API Key

python db_init.py --reset     # 创建 sales_demo 库、建表、随机造 40 家公司 + 数千条销售流水

# 方式一：直接问答
python sql_agent.py "今年销售额最高的10家公司"

# 方式二：打印工具调用过程（看 Agent 一步步调了哪些工具、SQL、结果）
python sql_agent.py "各行业今年的销售总额排名" --trace