如何利用 MCP 协议将本地 SQLite 数据库接入 Claude 实现自然语言查询

我这几天把本地的订单数据库接入了 Claude Desktop，实现了直接用自然语言问“上个月客单价最高的前五个产品是什么”就能出结果，而不需要我手动写 SQL 再复制结果。

核心配置路径

首先得安装 Node.js 环境，因为目前大部分 MCP Server 是用 TypeScript 写的。你需要修改 Claude Desktop 的配置文件（macOS 在 ~/Library/Application Support/Claude/claude_desktop_config.json）。

在 mcpServers 字段里加入 sqlite 配置：

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-sqlite",
        "--db",
        "/Users/yourname/data/my_database.db"
      ]
    }
  }
}

实战中的效率技巧

配置完重启 Claude 之后，你会发现输入框右下角多了一个小锤子图标。这里有个关键点：不要直接下模糊指令。

如果你直接问“分析一下数据”，Claude 可能会尝试扫描全表导致超时。最高效的链路是：
1. 先让它 list_tables 确认表结构。
2. 让它 describe_table 查看具体字段名和类型。
3. 最后下达分析指令。

比如我常用的 Prompt 组合：
查看 orders 表的结构，然后统计 2023 年 Q4 季度每个地区的总销售额，结果按降序排列。

踩过的坑与避雷指南

1. 路径必须是绝对路径：在 config.json 里写 ~/data/test.db 这种缩写，Claude 经常找不到文件，必须写全 /Users/username/...。

2. 权限死锁：如果你的 SQLite 数据库被某个 IDE（如 Navicat 或 DataGrip）以独占模式打开，MCP Server 可能会报 database is locked。建议在查询前确保没有其他进程在执行大规模写入。

3. 幻觉字段：有时候 Claude 会根据表名猜测字段（比如猜测有 user_id 其实你叫 uid）。如果它报错，直接把 describe_table 的结果甩给它，它能瞬间修正 SQL 语法。

性能对比

手动模式：思考 SQL → 编写 → 运行 → 导出 → 发给 AI 分析 → 结果。
MCP 模式：自然语言提问 → Claude 自动调用 query 工具 → 直接出答案。

这套流程把原本需要 5 分钟的分析缩短到了 10 秒钟，本质上是将 Claude 从一个“代码生成器”变成了真正的“数据库客户端”。