Mcp Server Sqlite

mcp-server-sqlite

通过 AI 助手查询 SQLite 数据库、检查架构并解释查询。默认只读，确保安全。

npx mcp-sqlite-server

适用于 Claude Desktop、Cursor、VS Code Copilot 和任何 MCP 客户端。读取本地 .db 文件，无需身份验证。

_{演示使用 remotion-readme-kit 构建}

为什么

SQLite 随处可见。它是移动应用、Electron 应用、本地优先工具以及日益增多的服务端项目（如 Turso、Cloudflare D1、Bun 内置的 SQLite）的默认数据库。官方 MCP 参考实现包含一个基础的 SQLite 服务，但它仅支持 Python。如果你使用 TypeScript/Node.js 环境，并希望询问助手“这个数据库中有哪些表？”或“运行这个查询并显示结果”，这个服务就能满足需求。它默认以只读模式打开数据库，让你可以安全地探索；需要时也可以选择启用写入模式。

工具

工具	功能
query	执行 SQL（SELECT、PRAGMA、EXPLAIN、WITH）。以表格形式返回结果。
schema	获取完整架构：所有表及其列、类型和行数。
table_info	获取单个表的详细信息：列、约束和行数。
explain	运行 EXPLAIN QUERY PLAN 以优化查询。
list_databases	列出目录中的 .db、.sqlite、.sqlite3 文件。

快速开始

Cursor

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": ["mcp-sqlite-server"]
    }
  }
}

Claude Desktop

添加到 claude_desktop_config.json（macOS：~/Library/Application Support/Claude/claude_desktop_config.json）：

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": ["mcp-sqlite-server"]
    }
  }
}

VS Code

在 VS Code 设置中配置 MCP 服务，以运行 npx mcp-sqlite-server。

示例提示词

• “显示 ./data.db 中数据库的架构”
• “查询 users 表：SELECT * FROM users LIMIT 10”
• “解释这个复杂联接的查询计划”
• “这个数据库中有哪些表？”
• “在当前目录中查找所有 .db 文件”

安全性

默认只读。在只读模式下，query 工具仅接受 SELECT、PRAGMA、EXPLAIN 和 WITH。将工具参数中的 readonly=false 设为 false，即可启用 INSERT、UPDATE、DELETE 等操作。

开发

npm install
npm run typecheck
npm run build
npm test
npm run format
npm run lint

另请参阅

可在我的作品集中查看更多 MCP 服务和开发者工具。

作者

---

_{README 使用 README Builder 构建}

许可证

MIT © 2026 Ofer Shapira