npm install
cp .env.example .env      # 填入 API key（DeepSeek 或 OpenRouter，见下）
npm run seed              # 生成演示库 demo.db（电商订单系统）
npm run smoke             # 冒烟测试（不依赖 key，验证协议与只读防护）
npm run e2e               # 端到端测试（3 个自然语言问题，需 key）
npm run chat              # 命令行直接问数据库（AI 自动查库回答）

> 哪个城市销售额最高?
🤖 销售额最高的城市是南京，约 ¥8.7 万（59 单）……

> 最近 30 天卖得最好的商品是?
> 买得最多的 3 个客户?

# ① DeepSeek 官方（推荐：便宜、快、国内可用）
DEEPSEEK_API_KEY=sk-xxx
DEEPSEEK_BASE_URL=https://api.deepseek.com
DEEPSEEK_MODEL=deepseek-chat

# ② OpenRouter 免费模型（demo 零成本，但每天限 50 次请求，充值 $10 解锁 1000 次）
DEEPSEEK_API_KEY=sk-or-v1-xxx
DEEPSEEK_BASE_URL=https://openrouter.ai/api/v1
DEEPSEEK_MODEL=nvidia/nemotron-3-super-120b-a12b:free   # 实测工具调用较稳

# ③ 本地 ollama（零成本、数据不出本机，需先装 ollama 并 pull qwen3:8b）
DEEPSEEK_API_KEY=
DEEPSEEK_BASE_URL=http://localhost:11434/v1
DEEPSEEK_MODEL=qwen3:8b

# ④ 任意 OpenAI 兼容服务（通义/豆包/GPT 等）
DEEPSEEK_BASE_URL=<你的服务地址>
DEEPSEEK_MODEL=<模型名>

{
  "mcpServers": {
    "db-connector": {
      "command": "/Users/wjy/.workbuddy/binaries/node/versions/22.22.2/bin/node",
      "args": ["--import", "tsx", "/Users/wjy/Documents/code/apps/mcp-demo-server/src/server.ts"]
    }
  }
}

AI 客户端 (DeepSeek Agent / Claude Desktop / Cursor)
        │  MCP 标准协议
        ▼
  db-connector (本仓库)
  ├── list_tables      → 自动发现数据结构
  ├── describe_table   → 查看表结构
  └── query            → 只读 SQL 查询（安全拦截非 SELECT）
        │
        ▼
  SQLite (demo.db) / PostgreSQL (生产)

src/
├── db.ts        # 数据库适配 + 只读防护
├── server.ts    # MCP Server（stdio 模式 + setupServer 复用）
├── agent.ts     # DeepSeek Agent（自然语言 → MCP 工具 → 回答）
├── cli.ts       # 命令行问答入口
├── seed.ts      # 生成演示数据库
└── smoke.ts     # 冒烟测试（不依赖 API key）