1. 为什么要在 Cursor 里用 MCP 接 SQLite本地开发调试时最烦的一件事就是数据不在手边。你写了一段查询逻辑想验证字段对不对、索引走没走、写入有没有触发约束结果要么去翻测试库连接串要么手动开个 SQLite 命令行敲半天。大模型本身再强它也不知道你本地那个product_list.db里到底有几张表、字段叫什么、库存还剩多少。它只能靠你贴 schema、贴数据贴一次两次还行改一次表结构就得重来。MCP 就是来解决这个断层的。全称 Model Context Protocol是 Anthropic 在 2024 年底开源的一套开放协议你可以把它理解成 AI 和外部资源之间的“通用插座”。数据库、文件系统、API、浏览器只要有人写了对应的 MCP ServerCursor 里的模型就能通过标准方式去调用而不是靠你复制粘贴上下文。SQLite 特别适合拿来做第一个练手对象单文件、零服务、跨平台装完就能跑出错也好回滚。这篇要交付的东西很具体一份可复制的mcp.json配置骨架把 SQLite MCP Server 挂到 Cursor 上同时把模型调用通道统一走 TaoToken 的 API 入口避免你在多个 Key 之间来回切换。然后给出一套三步验证动作让你在 Cursor 对话框里用自然语言完成建表、插入、查询、改价、删数据这一整条链路。适合谁看正在用 Cursor 做本地开发、手里有 SQLite 数据文件、想让 AI 直接读写的同学。如果你还没装 Cursor先去官网下个安装包这一步不展开。需要提前说清楚一个边界MCP 让模型能操作数据库不等于让它替你做生产决策。本地调试库随便折腾生产库的写操作一定要加审批或只读账号这个后面排障章节会再提。2. TaoToken 前置统一 Key 与 API 通道Cursor 本身支持自定义模型接入但如果你同时用 Claude、GPT 或者国产模型每个厂商一套 Key、一套计费、一套限流管理起来很碎。TaoToken 在这里的角色是提供一个统一的 API 通道你拿一个 Key就能在 Cursor 里切换不同模型MCP 的工具调用请求也走这条通道出去。对本地调试场景来说好处是配置只写一次换模型不用改 MCP 配置。先拿 Key。打开官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册后进控制台在 API Keys 页面创建一个新 Key。建议按用途命名比如cursor-local-sqlite方便后面排查是哪个客户端在调。Key 只显示一次复制到安全的地方别直接提交到 Git。拿到 Key 之后Cursor 的模型配置里填两样东西Base URL 用https://taotoken.net/apiAPI Key 填刚才那串。注意 API 地址不要加 UTM 参数那是给官网落地页用的接口调用带上反而可能出问题。配置入口在 Cursor 设置里的 Models 区域选 OpenAI Compatible 或 Anthropic 兼容模式具体看你用的模型类型。这里有个容易踩的点MCP Server 本身是本地进程它不直接调模型 API真正调模型的是 Cursor 客户端。所以 TaoToken 的 Key 是配在 Cursor 的模型设置里不是配在mcp.json里。mcp.json只负责告诉 Cursor 怎么启动 SQLite MCP Server、数据库文件在哪。两者职责分开别混在一起写。如果你后面要做长期编码或者 Agent 类任务可以考虑 Coding Plan额度模型更适合高频调用只是验证模型连通性的话用模型对话页面测一下就行。接入文档在 doc 页面API Keys 管理在 console 的 api-keys 页面这几个入口按需取用。3. 可复制配置SQLite MCP 与 mcp.json 骨架先把 SQLite 装上。macOS 用 Homebrewbrew install sqlite3 sqlite3 --versionWindows 可以去 SQLite 官网下预编译包把sqlite3.exe加到 PATHLinux 一般apt install sqlite3或yum install sqlite就行。装完在终端敲sqlite3能进交互界面输入.exit退出说明环境没问题。接着建工作目录和数据库文件。假设你放在桌面mkdir -p ~/Desktop/sqlite-mcp-test cd ~/Desktop/sqlite-mcp-test sqlite3 ./product_list.db进去之后建一张商品表字段设计得贴近真实场景一点CREATE TABLE IF NOT EXISTS product_list ( id INTEGER PRIMARY KEY AUTOINCREMENT, product_name TEXT NOT NULL, category TEXT, price REAL, stock INTEGER, created_at DATETIME DEFAULT CURRENT_TIMESTAMP ); .exit现在配置 MCP。Cursor 右上角设置 → Tools → Add MCP或者直接编辑mcp.json。下面这份骨架可以直接抄把路径换成你自己的{ mcpServers: { mcp-server-sqlite: { autoApprove: [], disabled: false, timeout: 60, command: mcp-server-sqlite, args: [ --db-path, /Users/yourname/Desktop/sqlite-mcp-test/product_list.db ], transportType: stdio } } }几个参数说明一下。command是启动 MCP Server 的可执行命令如果你用uvx或npx方式装这里要相应改成uvx加包名。args里的--db-path必须是绝对路径相对路径在 Cursor 启动子进程时容易解析错。transportType用stdio本地进程通信最稳。autoApprove留空表示每次工具调用都要你确认调试阶段建议保持这样避免模型误删数据。timeout给 60 秒复杂查询够用。如果你还没装mcp-server-sqlite用 pip 或 uv 装一下pip install mcp-server-sqlite # 或者 uvx mcp-server-sqlite --help装完回到 Cursor看 MCP 列表里mcp-server-sqlite旁边是不是绿色小点。绿色代表进程起来了、握手成功。如果是红色或灰色先别急着问模型往下看排障章节。4. 三步验证从建表到写入查询跑通配置生效后打开 Cursor 的 Chat 面板确认当前模型走的是 TaoToken 通道。然后按下面三步走每步都给出预期结果方便你对照。第一步建表并确认 schema。在对话框输入帮我在当前 SQLite 数据库里新建一张表 product_info 字段包括商品 id、商品名称、商品价格id 自增主键。 建完后把这张表的 schema 查出来给我看。模型会调用 MCP 的建表工具然后调查询工具返回PRAGMA table_info(product_info)的结果。你应该看到三行字段定义。如果它说“无法访问数据库”多半是--db-path写错了回到mcp.json检查绝对路径。第二步插入样例数据并查询。继续输入往 product_info 里插入 5 条样例数据 商品名称用手机型号价格在 3000 到 8000 之间。 插完后查询全表按价格降序排列。预期结果是模型先执行 INSERT再执行 SELECT返回 5 行记录。这里注意看它生成的 SQL 有没有用参数化写法如果直接拼字符串遇到带引号的商品名会报错。实测下来主流模型在 MCP 工具调用里一般会走参数绑定但你还是扫一眼确认。第三步改价和条件删除。输入把华为 P60 Pro 的价格改成 7000。 然后把价格低于 5000 的商品删掉删之前先查出来给我确认。这一步是验证写操作和条件过滤。好的实践是让模型“先查后删”你能在确认列表里看到即将被删的行再让它执行 DELETE。如果它直接删了说明autoApprove可能被设成了自动通过回去把它清空。三步跑完你已经在 Cursor 里用自然语言完成了建表、插入、查询、更新、删除的完整闭环。想再进一步可以试试多表关联再建一张stock_log表记录库存变动然后让模型关联product_list和stock_log查出“库存低于 10 且最近有出库记录的商品”。模型会自动找表、拼 JOIN这就是 MCP 把 schema 暴露给它的价值。5. 本篇常见错排查绿色小点不亮MCP Server 起不来。先看command能不能在终端直接跑。在终端执行mcp-server-sqlite --db-path /你的路径/product_list.db如果报 command not found说明没装或者不在 PATH 里。用which mcp-server-sqlite确认位置然后把command改成绝对路径。如果终端能跑但 Cursor 里不行检查 Cursor 是不是用了不同的 shell 环境必要时在mcp.json里加env字段补 PATH。模型说找不到表。九成是--db-path指向了另一个 db 文件。SQLite 是文件级数据库路径不同就是不同的库。在终端sqlite3 /你的路径/product_list.db .tables确认表在不在。另外注意如果你在 Cursor 里新建了 db 文件但没建表模型查不到表是正常的先让它建表。写入报错no such table或readonly database。前者是表没建后者是文件权限问题。检查 db 文件所在目录的写权限macOS 下ls -l看一眼。还有一种情况是 db 文件被其他进程锁住了比如你同时开着 DB Browser for SQLite关掉再试。模型调用工具时提示鉴权失败。这是 Cursor 的模型通道问题不是 MCP 的问题。去 Cursor 设置里确认 Base URL 是https://taotoken.net/apiKey 没有多余空格。可以在模型对话页面单独发一条消息测试连通性通了再回来跑 MCP。误删数据想恢复。SQLite 默认没有回收站DELETE 就是真删。调试阶段建议每次操作前用.backup命令备份sqlite3 product_list.db .backup product_list_backup.db或者干脆把 db 文件复制一份。如果已经删了且没有备份只能靠 WAL 日志或专业恢复工具成功率不高。所以autoApprove保持空、删除前先查这两个习惯比任何恢复手段都管用。MCP 工具列表里看不到 SQLite 相关工具。检查transportType是不是stdiodisabled是不是false。改完mcp.json后 Cursor 一般会提示重启点重启别只关窗口。6. 把通道和工具链固定下来本地调试跑通之后建议把配置沉淀成模板。mcp.json里数据库路径用环境变量占位不同项目复制一份改路径就行。Cursor 的模型通道固定走 TaoTokenKey 放在系统环境变量或 Cursor 的密钥管理里别硬编码进配置文件。这样你换项目、换模型、换数据库文件只需要动一两个字段MCP 工具链本身不用重配。后续如果要做更重的编码任务比如让 Agent 连续读写多个数据源可以了解 Coding Plan 的额度模型单纯验证模型对 SQLite 的理解能力用模型对话页面发几条自然语言查询就够了。接入细节和 Key 管理分别看接入文档和 console 的 api-keys 页面。整套流程的核心就一句话MCP 负责把本地数据源暴露给模型TaoToken 负责把模型调用收敛到一个通道两边各管各的配置一次长期复用。 
长河君 · 2026/9/29 20:25:34 · 阅读 1.2k Cursor+MCP 数据库操作实战：SQLite 配置文件与验证流程
1. 为什么要在 Cursor 里用 MCP 接 SQLite本地开发调试时最烦的一件事就是数据不在手边。你写了一段查询逻辑想验证字段对不对、索引走没走、写入有没有触发约束结果要么去翻测试库连接串要么手动开个 SQLite 命令行敲半天。大模型本身再强它也不知道你本地那个product_list.db里到底有几张表、字段叫什么、库存还剩多少。它只能靠你贴 schema、贴数据贴一次两次还行改一次表结构就得重来。MCP 就是来解决这个断层的。全称 Model Context Protocol是 Anthropic 在 2024 年底开源的一套开放协议你可以把它理解成 AI 和外部资源之间的“通用插座”。数据库、文件系统、API、浏览器只要有人写了对应的 MCP ServerCursor 里的模型就能通过标准方式去调用而不是靠你复制粘贴上下文。SQLite 特别适合拿来做第一个练手对象单文件、零服务、跨平台装完就能跑出错也好回滚。这篇要交付的东西很具体一份可复制的mcp.json配置骨架把 SQLite MCP Server 挂到 Cursor 上同时把模型调用通道统一走 TaoToken 的 API 入口避免你在多个 Key 之间来回切换。然后给出一套三步验证动作让你在 Cursor 对话框里用自然语言完成建表、插入、查询、改价、删数据这一整条链路。适合谁看正在用 Cursor 做本地开发、手里有 SQLite 数据文件、想让 AI 直接读写的同学。如果你还没装 Cursor先去官网下个安装包这一步不展开。需要提前说清楚一个边界MCP 让模型能操作数据库不等于让它替你做生产决策。本地调试库随便折腾生产库的写操作一定要加审批或只读账号这个后面排障章节会再提。2. TaoToken 前置统一 Key 与 API 通道Cursor 本身支持自定义模型接入但如果你同时用 Claude、GPT 或者国产模型每个厂商一套 Key、一套计费、一套限流管理起来很碎。TaoToken 在这里的角色是提供一个统一的 API 通道你拿一个 Key就能在 Cursor 里切换不同模型MCP 的工具调用请求也走这条通道出去。对本地调试场景来说好处是配置只写一次换模型不用改 MCP 配置。先拿 Key。打开官网https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content注册后进控制台在 API Keys 页面创建一个新 Key。建议按用途命名比如cursor-local-sqlite方便后面排查是哪个客户端在调。Key 只显示一次复制到安全的地方别直接提交到 Git。拿到 Key 之后Cursor 的模型配置里填两样东西Base URL 用https://taotoken.net/apiAPI Key 填刚才那串。注意 API 地址不要加 UTM 参数那是给官网落地页用的接口调用带上反而可能出问题。配置入口在 Cursor 设置里的 Models 区域选 OpenAI Compatible 或 Anthropic 兼容模式具体看你用的模型类型。这里有个容易踩的点MCP Server 本身是本地进程它不直接调模型 API真正调模型的是 Cursor 客户端。所以 TaoToken 的 Key 是配在 Cursor 的模型设置里不是配在mcp.json里。mcp.json只负责告诉 Cursor 怎么启动 SQLite MCP Server、数据库文件在哪。两者职责分开别混在一起写。如果你后面要做长期编码或者 Agent 类任务可以考虑 Coding Plan额度模型更适合高频调用只是验证模型连通性的话用模型对话页面测一下就行。接入文档在 doc 页面API Keys 管理在 console 的 api-keys 页面这几个入口按需取用。3. 可复制配置SQLite MCP 与 mcp.json 骨架先把 SQLite 装上。macOS 用 Homebrewbrew install sqlite3 sqlite3 --versionWindows 可以去 SQLite 官网下预编译包把sqlite3.exe加到 PATHLinux 一般apt install sqlite3或yum install sqlite就行。装完在终端敲sqlite3能进交互界面输入.exit退出说明环境没问题。接着建工作目录和数据库文件。假设你放在桌面mkdir -p ~/Desktop/sqlite-mcp-test cd ~/Desktop/sqlite-mcp-test sqlite3 ./product_list.db进去之后建一张商品表字段设计得贴近真实场景一点CREATE TABLE IF NOT EXISTS product_list ( id INTEGER PRIMARY KEY AUTOINCREMENT, product_name TEXT NOT NULL, category TEXT, price REAL, stock INTEGER, created_at DATETIME DEFAULT CURRENT_TIMESTAMP ); .exit现在配置 MCP。Cursor 右上角设置 → Tools → Add MCP或者直接编辑mcp.json。下面这份骨架可以直接抄把路径换成你自己的{ mcpServers: { mcp-server-sqlite: { autoApprove: [], disabled: false, timeout: 60, command: mcp-server-sqlite, args: [ --db-path, /Users/yourname/Desktop/sqlite-mcp-test/product_list.db ], transportType: stdio } } }几个参数说明一下。command是启动 MCP Server 的可执行命令如果你用uvx或npx方式装这里要相应改成uvx加包名。args里的--db-path必须是绝对路径相对路径在 Cursor 启动子进程时容易解析错。transportType用stdio本地进程通信最稳。autoApprove留空表示每次工具调用都要你确认调试阶段建议保持这样避免模型误删数据。timeout给 60 秒复杂查询够用。如果你还没装mcp-server-sqlite用 pip 或 uv 装一下pip install mcp-server-sqlite # 或者 uvx mcp-server-sqlite --help装完回到 Cursor看 MCP 列表里mcp-server-sqlite旁边是不是绿色小点。绿色代表进程起来了、握手成功。如果是红色或灰色先别急着问模型往下看排障章节。4. 三步验证从建表到写入查询跑通配置生效后打开 Cursor 的 Chat 面板确认当前模型走的是 TaoToken 通道。然后按下面三步走每步都给出预期结果方便你对照。第一步建表并确认 schema。在对话框输入帮我在当前 SQLite 数据库里新建一张表 product_info 字段包括商品 id、商品名称、商品价格id 自增主键。 建完后把这张表的 schema 查出来给我看。模型会调用 MCP 的建表工具然后调查询工具返回PRAGMA table_info(product_info)的结果。你应该看到三行字段定义。如果它说“无法访问数据库”多半是--db-path写错了回到mcp.json检查绝对路径。第二步插入样例数据并查询。继续输入往 product_info 里插入 5 条样例数据 商品名称用手机型号价格在 3000 到 8000 之间。 插完后查询全表按价格降序排列。预期结果是模型先执行 INSERT再执行 SELECT返回 5 行记录。这里注意看它生成的 SQL 有没有用参数化写法如果直接拼字符串遇到带引号的商品名会报错。实测下来主流模型在 MCP 工具调用里一般会走参数绑定但你还是扫一眼确认。第三步改价和条件删除。输入把华为 P60 Pro 的价格改成 7000。 然后把价格低于 5000 的商品删掉删之前先查出来给我确认。这一步是验证写操作和条件过滤。好的实践是让模型“先查后删”你能在确认列表里看到即将被删的行再让它执行 DELETE。如果它直接删了说明autoApprove可能被设成了自动通过回去把它清空。三步跑完你已经在 Cursor 里用自然语言完成了建表、插入、查询、更新、删除的完整闭环。想再进一步可以试试多表关联再建一张stock_log表记录库存变动然后让模型关联product_list和stock_log查出“库存低于 10 且最近有出库记录的商品”。模型会自动找表、拼 JOIN这就是 MCP 把 schema 暴露给它的价值。5. 本篇常见错排查绿色小点不亮MCP Server 起不来。先看command能不能在终端直接跑。在终端执行mcp-server-sqlite --db-path /你的路径/product_list.db如果报 command not found说明没装或者不在 PATH 里。用which mcp-server-sqlite确认位置然后把command改成绝对路径。如果终端能跑但 Cursor 里不行检查 Cursor 是不是用了不同的 shell 环境必要时在mcp.json里加env字段补 PATH。模型说找不到表。九成是--db-path指向了另一个 db 文件。SQLite 是文件级数据库路径不同就是不同的库。在终端sqlite3 /你的路径/product_list.db .tables确认表在不在。另外注意如果你在 Cursor 里新建了 db 文件但没建表模型查不到表是正常的先让它建表。写入报错no such table或readonly database。前者是表没建后者是文件权限问题。检查 db 文件所在目录的写权限macOS 下ls -l看一眼。还有一种情况是 db 文件被其他进程锁住了比如你同时开着 DB Browser for SQLite关掉再试。模型调用工具时提示鉴权失败。这是 Cursor 的模型通道问题不是 MCP 的问题。去 Cursor 设置里确认 Base URL 是https://taotoken.net/apiKey 没有多余空格。可以在模型对话页面单独发一条消息测试连通性通了再回来跑 MCP。误删数据想恢复。SQLite 默认没有回收站DELETE 就是真删。调试阶段建议每次操作前用.backup命令备份sqlite3 product_list.db .backup product_list_backup.db或者干脆把 db 文件复制一份。如果已经删了且没有备份只能靠 WAL 日志或专业恢复工具成功率不高。所以autoApprove保持空、删除前先查这两个习惯比任何恢复手段都管用。MCP 工具列表里看不到 SQLite 相关工具。检查transportType是不是stdiodisabled是不是false。改完mcp.json后 Cursor 一般会提示重启点重启别只关窗口。6. 把通道和工具链固定下来本地调试跑通之后建议把配置沉淀成模板。mcp.json里数据库路径用环境变量占位不同项目复制一份改路径就行。Cursor 的模型通道固定走 TaoTokenKey 放在系统环境变量或 Cursor 的密钥管理里别硬编码进配置文件。这样你换项目、换模型、换数据库文件只需要动一两个字段MCP 工具链本身不用重配。后续如果要做更重的编码任务比如让 Agent 连续读写多个数据源可以了解 Coding Plan 的额度模型单纯验证模型对 SQLite 的理解能力用模型对话页面发几条自然语言查询就够了。接入细节和 Key 管理分别看接入文档和 console 的 api-keys 页面。整套流程的核心就一句话MCP 负责把本地数据源暴露给模型TaoToken 负责把模型调用收敛到一个通道两边各管各的配置一次长期复用。