1 v0.1.3 更新于 2026-10-24

SQLite MCP Sidecar MCP Server

Agent-safe MCP sidecar for one live SQLite database: read-only default, bounded writes.

适用客户端

本地客户端
Claude Desktop、Claude Code、Cursor、Cline 等支持本地 MCP 的客户端

安装配置

本地运行(docker)
{
  "mcpServers": {
    "sqlite-mcp-sidecar": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/xakpc/sqlite-mcp-sidecar:0.1.3"
      ]
    }
  }
}

将上方 JSON 加入 MCP 客户端配置(如 Claude Desktop 的 claude_desktop_config.json 或项目的 .mcp.json)即可接入;远程接入按客户端要求填写 URL 与鉴权头。

提供的工具 接入后 Agent 可调用这 8 个工具

schema
返回用户表、视图和索引的 DDL 元数据,不包含行数据。
query
执行一条调用方编写的只读 SQL 语句,以 TOON 格式返回受行数、字节限制和超时约束的查询结果。
insert
根据表名和值映射插入一行,调用方无需编写 SQL。
update
通过结构化过滤器更新匹配的行,必须提供过滤器和 maxRows 行数上限。
delete
通过结构化过滤器删除匹配的行,必须提供过滤器和 maxRows 行数上限。
backup
在应用程序持续写入的同时复制在线数据库,返回任务供客户端轮询结果。
diagnostics
报告固定的健康检查指标,包括日志模式和 quick_check 结果。
execute_write_sql
执行调用方编写的 INSERT、UPDATE 或 DELETE 原生 SQL 语句,需启用 danger-raw-write 权限。