如何配置 MCP 伺服器让 Claude 直接读写本地 SQLite 数据库

把 Claude Code 或 Cursor 挂载到本地 SQLite 数据库，能让 AI 从“猜字段”变成“查数据”，在调试本地缓存或分析日志时效率极高。很多人卡在 MCP (Model Context Protocol) 的配置路径上，其实核心就在于 claude_desktop_config.json 的正确映射。

目前最稳的方案是直接用官方提供的 SQLite MCP Server。先确保环境里有 Node.js，然后通过以下命令安装：

npm install -g @modelcontextprotocol/server-sqlite

配置的关键在于路径。如果你在 macOS 上，配置文件路径是 ~/Library/Application Support/Claude/claude_desktop_config.json。不要直接在编辑器里写相对路径，AI 识别不到，必须写绝对路径。

配置示例如下：

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

这里有个踩坑点：如果你使用的是 Cursor 的 MCP 界面，记得在 Settings -> MCP 中添加，但建议优先通过 Claude Desktop 配置文件生效，因为这样能确保 runtime 环境的一致性。

实际操作中，我发现直接让 AI “分析数据库”太宽泛，容易触发大量不必要的全表扫描。最高效的用法是给它一个具体的 SQL 目标，比如：

使用 sqlite 伺服器查询 users 表中最近 24 小时注册且状态为 active 的用户数量，并把结果直接写入到 debug_log 表中。

这种读写闭环最爽的地方在于，它能直接执行 PRAGMA table_info(table_name); 来自省表结构，你不再需要手动把 DDL 粘贴给 AI。

效率提升最明显的是在处理复杂关联查询时。以前我得在 Navicat 跑 SQL，把结果贴给 AI，它再帮我写逻辑。现在直接在对话框里说「帮我核对一下 orders 表和 payments 表的金额是否对齐」，它会自动执行多条查询语句并对比结果，省去了在两个窗口之间切换的心智负担。

如果运行报错 command not found: npx，通常是因为 Claude Desktop 启动时的环境变量没加载 Shell 的 Path，这时候把 npx 替换成绝对路径（通过 which npx 查看）就能解决。