┌───────────────┐     ┌─────────────────────┐
│ 浏览器 Web UI │ ──▶ │  FastAPI 后端       │
└───────────────┘     │  /api/ask           │
                      │  ├─ DeepSeek (生成SQL)│
                      │  ├─ SQL 安全校验     │
                      │  └─ 数据库适配层     │
                      └──────┬───────────────┘
                             │
       ┌─────────────────────┼─────────────────────┐
       ▼                     ▼                     ▼
   MySQL                  达梦 DM            人大金仓
                       (dmPython)          (psycopg2)


另外，项目也暴露一个标准的 MCP Server（stdio 协议），
可以直接挂到 Cursor / Claude Desktop 里使用。

10.mcp/
├── requirements.txt
├── .env.example                # 环境变量模板（API Key、端口等）
├── config/
│   ├── databases.yaml.example  # 数据库连接配置模板
│   └── glossary.yaml           # 业务术语表 + Few-shot 样例
├── src/
│   ├── core/
│   │   ├── config.py           # 配置加载
│   │   ├── manager.py          # 数据库连接管理
│   │   ├── adapters/           # 三数据库适配器（mysql/dameng/kingbase）
│   │   └── security/
│   │       └── sql_validator.py  # SQL 安全校验（白名单 + 强制 LIMIT）
│   ├── mcp_server/
│   │   └── server.py           # MCP Server 入口（stdio）
│   └── webapp/
│       ├── main.py             # FastAPI 后端
│       ├── llm.py              # DeepSeek 调用
│       ├── prompts.py          # 系统提示词
│       └── static/index.html   # 单页 Web UI
├── scripts/
│   ├── install_dameng_driver.md
│   ├── install_kingbase_driver.md
│   └── platform_db_init.py     # 平台 PG 建表（Alembic upgrade head）
├── migrations/
│   └── platform/               # Alembic 迁移（多企业租户控制面）
└── tests/
    └── test_sql_validator.py

cd G:\phpstudy_pro\WWW\10.mcp
python -m venv .venv
.\.venv\Scripts\Activate.ps1
pip install -r requirements.txt

copy .env.example .env
copy config\databases.yaml.example config\databases.yaml

PLATFORM_DATABASE_URL=postgresql://mcp_app:密码@127.0.0.1:5432/mcp_platform
PLATFORM_SECRET_KEY=<openssl rand -hex 32>

.\.venv\Scripts\pip.exe install -r requirements.txt
.\.venv\Scripts\python.exe scripts\platform_db_init.py

BOOTSTRAP_ADMIN_USER=admin
BOOTSTRAP_ADMIN_PASSWORD=你的强密码

.\.venv\Scripts\python.exe scripts\migrate_files_to_platform_pg.py --dry-run
.\.venv\Scripts\python.exe scripts\migrate_files_to_platform_pg.py `
  --default-enterprise-code default --default-enterprise-name 默认企业

.\.venv\Scripts\python.exe -m pytest tests/ -v

.\.venv\Scripts\python.exe -m uvicorn src.webapp.main:app --host 127.0.0.1 --port 8765 --reload

{
  "mcpServers": {
    "db-qa": {
      "command": "G:/phpstudy_pro/WWW/10.mcp/.venv/Scripts/python.exe",
      "args": ["-m", "src.mcp_server.server"],
      "cwd": "G:/phpstudy_pro/WWW/10.mcp"
    }
  }
}

cd G:\phpstudy_pro\WWW\10.mcp
.\scripts\start-mcp-8001-local-test.ps1
# 或：.\scripts\start-mcp-8002-zh-data-dm-only.ps1 -InstanceId <8002实例UUID>

# 首次执行：创建隔离的本地测试企业并复制数据库连接（正式企业不修改）
.\.venv\Scripts\python.exe scripts\local\provision_local_test_enterprise.py --pg-host 192.168.1.185

# 8001：只从 zhenhai-local-test 企业渲染配置，含 26 个工具
.\scripts\start-mcp-8001-local-test.ps1 -EnterpriseCode zhenhai-local-test

# 8002：zh_data_dm_only，25 个工具，可见 alias 只能是 ZH_DATA + ZH_DWD
.\scripts\start-mcp-8002-zh-data-dm-only.ps1 -InstanceId <8002实例UUID>

.\.venv\Scripts\python.exe -m pytest tests/ -v
# 已覆盖 20 个用例：合法 SELECT 通过 / 各种 DML/DDL/多语句/危险函数 全部拦截

CREATE USER 'mcp_readonly'@'localhost' IDENTIFIED BY 'a-strong-password';
GRANT SELECT ON your_db.* TO 'mcp_readonly'@'localhost';
FLUSH PRIVILEGES;