快速配置
选择适合您环境的设置。
最后验证: 2026-06-13
验证环境: uvx 运行 mcp-server-sqlite,使用 stdio
安装命令:
uvx mcp-server-sqlite --db-path /path/to/database.db验证提示词
列出所有数据表,并描述各自的列结构。
成功时应看到
应看到该 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 个取值及其数量。