@lubo3395/mcp-sqlite-server

SQLite 数据库 MCP 服务器 — 让 AI 助手（Claude、Cursor、VS Code Copilot 等）通过 MCP 协议直接操作 SQLite 数据库。

Node 版本要求：>= 22 基于 Node.js 内置 node:sqlite，无需任何原生编译依赖，开箱即用。 如果你的 Node 版本低于 22，请升级 Node 或联系我们讨论其他方案。

功能

工具	功能	读写
sqlite_query	执行任意 SQL 语句（支持参数化查询）	R+W
sqlite_list_tables	列出所有表名及行数	R
sqlite_get_schema	查看表的结构、列、索引和 DDL	R
sqlite_create_table	创建新表	W
sqlite_drop_table	删除表	W
sqlite_add_column	添加列	W
sqlite_create_index	创建索引	W
sqlite_drop_index	删除索引	W
sqlite_import_csv	从 CSV 文件导入数据	W
sqlite_import_json	从 JSON 文件导入数据	W
sqlite_export_csv	查询结果导出为 CSV	R
sqlite_export_json	查询结果导出为 JSON	R

安全

支持 --readonly 只读模式。启用后：

• better-sqlite3 驱动层拒绝写入
• sqlite_query 只允许 SELECT / PRAGMA / EXPLAIN / WITH
• DDL 和导入工具全部拦截

安装

npx 直接使用（推荐）

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": ["-y", "@lubo3395/mcp-sqlite-server", "--db", "./data.db", "--max-rows", "200"]
    }
  }
}

全局安装

npm install -g @lubo3395/mcp-sqlite-server
mcp-sqlite-server --db ./data.db --max-rows 200

配置

Claude Desktop / Claude Code

在 claude_desktop_config.json 或 claude.json 中添加：

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": ["-y", "@lubo3395/mcp-sqlite-server", "--db", "D:/path/to/data.db", "--max-rows", "200"],
      "env": {}
    }
  }
}

只读模式：

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": ["-y", "@lubo3395/mcp-sqlite-server", "--db", "D:/path/to/data.db", "--readonly", "--max-rows", "200"]
    }
  }
}

多数据库：

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": ["-y", "@lubo3395/mcp-sqlite-server", "--db", "./main.db", "--db", "./reference.db", "--max-rows", "200"]
    }
  }
}

VS Code / GitHub Copilot

在 .vscode/mcp.json 中添加：

{
  "servers": {
    "sqlite": {
      "command": "npx",
      "args": ["-y", "@lubo3395/mcp-sqlite-server", "--db", "./data.db", "--max-rows", "200"]
    }
  }
}

Cursor

在 .cursor/mcp.json 中添加：

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": ["-y", "@lubo3395/mcp-sqlite-server", "--db", "./data.db", "--max-rows", "200"]
    }
  }
}

Cline / Roo Code

在 cline.json 中添加：

{
  "mcpServers": {
    "sqlite": {
      "command": "npx",
      "args": ["-y", "@lubo3395/mcp-sqlite-server", "--db", "./data.db", "--max-rows", "200"]
    }
  }
}

Tool 详情

sqlite_query

执行 SQL 语句，支持参数化查询防止注入。查询结果自动截断（默认最多 200 行），避免浪费 token。

参数	类型	必填	说明
sql	string	是	SQL 语句
params	array	否	参数化查询参数（? 占位符）
limit	number	否	返回行数上限（默认 200，受 --max-rows 限制）
offset	number	否	跳过的行数，配合 limit 分页
db_alias	string	否	数据库别名

示例：

查询: SELECT * FROM users WHERE age > ?
参数: [25]
分页: limit=50, offset=100

返回值包含 total_count（总行数）和 has_more（是否还有更多），AI 可据此决定是否继续分页。

sqlite_list_tables

列出所有表名及行数。

参数	类型	必填	说明
db_alias	string	否	数据库别名

sqlite_get_schema

查看指定表的结构信息。

参数	类型	必填	说明
table	string	是	表名
db_alias	string	否	数据库别名

sqlite_create_table

创建新表。

参数	类型	必填	说明
table	string	是	表名
columns	string	是	列定义 JSON（见下方说明）
if_not_exists	boolean	否	是否添加 IF NOT EXISTS
db_alias	string	否	数据库别名

columns 参数格式：

[
  {"name": "id", "type": "INTEGER", "pk": true, "autoIncrement": true},
  {"name": "name", "type": "TEXT", "notnull": true},
  {"name": "email", "type": "TEXT", "unique": true},
  {"name": "age", "type": "INTEGER", "defaultValue": "0"}
]

sqlite_drop_table / sqlite_add_column / sqlite_create_index / sqlite_drop_index

分别为删除表、添加列、创建索引、删除索引。支持 if_exists / if_not_exists 和 db_alias 参数。

sqlite_import_csv / sqlite_import_json

从文件导入数据到表。支持 create_if_not_exists 自动建表。

参数	类型	必填	说明
file_path	string	是	文件路径
table	string	是	目标表名
create_if_not_exists	boolean	否	自动建表
delimiter	string	否	分隔符（CSV，默认 ,）
has_header	boolean	否	是否含表头（CSV，默认 true）

sqlite_export_csv / sqlite_export_json

将查询结果导出到文件。

参数	类型	必填	说明
sql	string	是	SELECT 查询
output	string	是	输出文件路径
params	array	否	参数化查询参数
overwrite	boolean	否	是否覆盖已有文件

命令行参数

mcp-sqlite-server --db <path> [选项...]

--db <path>        SQLite 数据库文件路径（必填，可指定多个）
--readonly         只读模式（禁止写操作）
--max-rows <n>     查询返回的最大行数上限（默认 200，设为 0 不限制）
--help, -h         显示帮助

本地开发

git clone https://github.com/lubo3395/mcp-sqlite-server.git
cd mcp-sqlite-server
npm install
npm run dev        # 开发模式（热重载）
npm run build      # 构建
npm start          # 启动

使用 MCP Inspector 测试：

npx @modelcontextprotocol/inspector node dist/index.js --db ./test.db

技术栈

• 运行时: Node.js 22+（内置 node:sqlite）
• MCP SDK: @modelcontextprotocol/sdk
• 校验: zod
• 构建: TypeScript + tsc

License

MIT