🗄️

SQLite

查询本地 SQLite 数据库,用于快速分析与报告。

分类: 数据库
难度: 简单

快速配置

选择适合您环境的设置。

最后验证: 2026-06-13
验证环境: uvx 运行 mcp-server-sqlite,使用 stdio
安装命令: uvx mcp-server-sqlite --db-path /path/to/database.db

本地配置

JSON
本地配置 json
{
  "sqlite": {
    "command": "uvx",
    "args": ["mcp-server-sqlite", "--db-path", "/path/to/database.db"]
  }
}

复制后下一步

先用配置检查器验证 SQLite JSON,再回到 OpenClaw 运行验证提示词。

验证提示词

列出所有数据表,并描述各自的列结构。

成功时应看到

应看到该 SQLite 文件的表列表与列定义。

常见陷阱与修复

  • ⚠️ 注意: 数据库文件路径权限,以及安全执行写入类查询。
  • 🔑 始终将 API 密钥存储在环境变量中,切勿硬编码在 JSON 中。
  • 🛡️ 如果可用,从只读权限开始,以安全地验证连接。

安全检查

  • 把 --db-path 指向具体的数据库文件,而不是装有无关数据的目录。
  • 在允许任何写入查询前先备份数据库。

常见错误

错误 原因 修复方法
uvx not found 未安装 uv 或不在 PATH 中。 安装 uv(提供 uvx),或用 pipx 安装该服务。
unable to open database file --db-path 有误或不可读。 使用进程可读的、已存在的 .db 文件的绝对路径。
attempt to write a readonly database 文件或目录不可写。 仅在确实要执行写入查询时才赋予写权限。

示例提示词

连接后,尝试这些提示词以测试功能:

  • 列出所有数据表,并描述每张表的列结构。
  • 运行示例查询获取某表最近 20 条记录,并总结发现的模式。
  • 统计某列最常见的前 10 个取值及其数量。