Litescope 是一个面向生产环境 SQLite 的运维工具链，主要服务于 Cloudflare D1、Turso 以及本地 SQLite 文件。它旨在解决 SQLite 在生产规模化场景下缺乏可观测性和运维工具的问题，尤其针对多租户架构中每个租户一个数据库、数据库数量可达数千个的情况。
用途
Litescope 用于对 SQLite 数据库进行运维管理，包括检查、diff、迁移、监控、备份和修复。它同时为 AI 智能体提供安全的数据库操作接口，让智能体能够安全地接触生产 SQLite：在写入前进行诊断，在写入后可以回滚。
主要能力
- MCP 集成：通过 MCP 协议让 Claude 等智能体直接访问 D1 数据库。提供 Claude Code 插件，包含 MCP 服务器和五个技能（lock doctor、safe writes、migration review、fleet sweep、corruption recovery）。支持 Cursor、Claude Desktop、Windsurf 等 MCP 客户端。
- 只读工具：
litescope_query强制 token 预算，包括 max_rows 上限、列投影和截断报告，避免大表撑爆智能体上下文窗口。 - 写入工具：默认关闭，需以
--allow-writes启动；每次写入默认 dry-run，且没有自动捕获的撤销点就不会提交。 - 提示与资源：MCP 服务器暴露 prompts（如 diagnose_locked_database、review_migration、safe_optimize、health_checkup）和 resources（schema、数据字典、实时健康、实时锁诊断），可订阅推送更新。
- 交互式视图（MCP Apps）：四个工具在对话内返回交互面板，视图为自包含文档，不加载网络资源，不写入。
- 远程/托管（Streamable HTTP）：支持 stdio 和 Streamable HTTP 传输，可配置 token 和 Origin 白名单。
- D1 CLI 操作：Rewind（D1 Time Travel）、Pull/Push（D1 与本地 SQLite 同步）、Migrate（D1 schema 变更）、Bisect（二分查找破坏 D1 数据库的提交）。
- doctor：一次性检查，组合完整性检查、WAL/碎片健康、索引顾问和 schema lint，可作为 CI 质量门禁。
- snapshot / restore：时间点备份，快照存于 .litescope-snapshots/ 目录，恢复前先做完整性检查和预恢复安全快照。
- autopilot：自驱动优化，运行 ANALYZE + PRAGMA optimize，添加缺失外键索引，可选 VACUUM 和删除冗余索引，默认 dry-run，真实变更前自动快照。
- locks：诊断“database is locked”，检查 journal mode、busy_timeout、locking mode 和 WAL 膨胀，给出 PRAGMA/DSN 修复建议；--live 识别当前持锁进程；--watch 记录历史，--timeline 聚合争用视图。
- diff：schema 和数据 diff。
- migrate：生成并应用迁移，应用安全序列包括预检完整性检查、VACUUM INTO 备份、单事务、外键验证、失败自动回滚。
- lint：schema 反模式检查，规则包括 no-primary-key、untyped-column、not-strict、autoincrement-overhead、non-integer-pk。
- schema：检查 schema 和 ERD。
- dump：可移植 SQL 导出。
- import / export：支持 CSV、TSV、JSON、Excel（.xlsx），无外部依赖。
- monitor：schema 漂移检测。
- serve：本地 Web 仪表盘，包含 fleet 拓扑图、健康分诊、schema 指纹、交互式 ERD、分页数据浏览器、可视化查询构建器、拖放导入和可视化 diff 面板。
- CI GitHub Action：在每个 pull request 上运行 Litescope，lint schema、与基础分支 diff，并评论影响范围。
- npm / npx：面向 JS 和 wrangler 用户，无需单独安装。
- 二进制下载：支持 macOS、Linux、Windows。
使用方式
- 安装 Claude Code 插件，获得 MCP 服务器和五个技能。
- 仅安装 MCP 服务器（只读）：一行命令。
- 启用写入和 D1：需添加
--allow-writes和 Cloudflare 环境变量，Litescope 仍会 dry-run 每次写入并在应用前捕获回滚点。 - Cursor：一键添加 litescope（只读安装；在 mcp.json 中添加
--allow-writes和 Cloudflare 环境变量以启用写入）。 - Claude Desktop / Windsurf / 任何 MCP 客户端：直接添加到配置文件。
- 远程/托管：使用 Streamable HTTP 传输，POST JSON-RPC 消息到端点（默认 /mcp）。公开暴露前需用
--http-token（或 LITESCOPE_MCP_TOKEN 环境变量）和--http-origin锁定。 - 绑定数据库：
litescope mcp ./app.db，或通过litescope://schema/{source}、litescope://dictionary/{source}、litescope://health/{source}、litescope://locks/{source}访问任意源。
适用场景
- 多租户应用在 Turso 和 D1 上管理数百个数据库。
- 需要让 AI 智能体安全地修改生产数据库，并具备回滚能力。
- 在 CI 中检查 schema 变更和迁移风险。
- 诊断数据库锁、WAL 膨胀、schema 漂移等问题。
- 对本地和 Turso 数据库进行时间点备份和恢复。
限制
- 写入工具默认关闭，需显式启用。
- 远程 HTTP 端点若无 token 则开放，服务器会打印警告。
- 交互式视图不执行写入，按钮操作会交回对话。
- 托管仪表盘为付费服务，但软件和所有功能免费且可自托管。
- 商业许可证（AGPL 例外 + 支持 SLA）需联系获取。
- 具体价格、托管计划细节暂未提供。
