AI ──SQL──▶ 风险分级 ──▶ 只读?──执行──┐
                 │                    ├─▶ 结果（含 audit_id）
                 └─ WRITE/DANGER ──▶ confirm_token 两段式确认
                            全程 ──▶ SQLite 审计哈希链（append-only + verify）

# 推荐：uvx（无需自装 Python 环境）
uvx --from sqlmcp sqlmcp --help

# 或 pip
pip install sqlmcp            # 核心包
pip install "sqlmcp[mysql]"   # + MySQL 驱动
pip install "sqlmcp[postgres]"# + PostgreSQL 驱动

# 1. 初始化 ~/.sql-mcp/（config 模板 + 审计库 + master.key + token 密钥，ACL 限当前用户）
sqlmcp init

# 2. 编辑配置（或直接用 UI：sqlmcp ui，保存时明文密码自动加密）
#    ~/.sql-mcp/config.json
sqlmcp ui

# 3. 自检（驱动/配置/密钥/审计链全绿即可接入客户端）
sqlmcp doctor

{
  "version": 1,
  "databases": {
    "appdb": {
      "type": "mysql", "host": "127.0.0.1", "port": 3306,
      "user": "app", "password": "填明文后由 UI/encrypt 自动加密为 enc:v1:…",
      "database": "appdb", "access": "read_only"
    },
    "scratch": {
      "type": "sqlite", "path": "D:/tmp/scratch.sqlite",
      "access": "read_write_danger",
      "danger_whitelist": []
    }
  },
  "audit": { "max_rows": 1000, "log_results": false },
  "ui": { "port": 7421, "idle_timeout_min": 120 }
}

{
  "mcpServers": {
    "sqlmcp": {
      "command": "uvx",
      "args": ["--from", "sqlmcp", "sqlmcp", "serve"],
      "env": {}
    }
  }
}

{ "command": "uvx", "args": ["--from", "sqlmcp", "sqlmcp", "serve"] }

使用 sqlmcp 操作数据库时遵守：
1. 先 list_databases 看可用库，db_name 必须来自该清单，不确定就先查，禁止猜别名；
2. 写操作前先 dry_run 看风险级别；DANGER 级必须先把 SQL 原文展示给用户、
   等用户明确同意后，再走 execute(空 token) → 拿 confirm_token → 带 token 重发；
3. 禁止替用户决定执行危险操作，禁止绕过/猜测 confirm_token；
4. 被拦截（BLOCKED）是安全机制生效，不要重试绕过，向用户说明原因；
5. 结论需要佐证时用 audit_query 拉原始记录，用 audit_verify 自证链完整。

sqlmcp init      # 初始化目录/审计库/配置模板/密钥
sqlmcp ui        # 本地控制台（默认 http://127.0.0.1:7421）
sqlmcp serve     # 启动 MCP stdio 服务（客户端接这个）
sqlmcp doctor    # 自检：驱动/配置/密钥/审计链
sqlmcp rekey     # 轮换 master.key（全量密文重加密，自动备份）
sqlmcp verify    # CLI 校验哈希链
sqlmcp export    # 审计导出自包含 HTML

pip install -e ".[mysql]" pytest httpx
pytest tests -q          # 全量测试
python -m build          # 构建产物