1. 为什么要在 Claude 里接一个本地 SQLite 的 MCP Server很多人第一次听到「Claude 通过 MCP 协议访问本地 SQLite 数据库」会以为要写一堆胶水代码其实核心就一件事让 Claude 这个客户端知道「有一个叫 sqlite 的工具它能执行 SQL数据库文件在某个路径」。MCPModel Context Protocol本质上是给大模型挂外设的协议SQLite 只是其中一种最常见的本地数据源。你把它接上之后问一句「产品表里现在有多少商品」Claude 会自己决定调用工具、拼 SQL、拿结果再用人话回你。这个场景特别适合几类人做小工具/独立开发的本地有个test.db存产品、订单、库存不想为了查个数就开个数据库客户端做数据整理的手里一堆 SQLite 文件想用自然语言快速统计还有正在学 MCP 协议的SQLite 是最容易跑通的第一个 Server因为它不需要网络、不需要鉴权、一个文件就是全部。我试过把产品表接到 Claude 里做数量统计落地下来最省事的路径是本地建库 → 配 MCP Server → 在 Claude 里验证查询。整条链路里最容易卡住的不是 SQL而是配置文件路径写错、uvx没装、数据库文件权限不对。这篇就按「产品表商品数量统计」这个具体目标把可复制的配置和验证步骤拆开讲你照着改路径就能跑。需要说明的是Claude 桌面端本身负责「对话 调用工具」而真正执行 SQL 的是本地那个 MCP Server 进程。所以配置的重点是让 Claude 找到并启动这个进程。下面所有配置都以 macOS 为例Windows 只需把路径换成C:\\Users\\...的形式逻辑完全一致。2. 前置准备SQLite 数据库、uvx 与 MCP Server 的安装配置在动 Claude 的配置之前先把「数据」和「执行环境」准备好。这一步做完后面配 MCP 就是填空。2.1 建一个带产品表的 SQLite 库先确认本机有sqlite3命令macOS/Linux 一般自带Windows 可装 SQLite 工具包。然后建库建表并塞几条测试数据sqlite3 ~/test.db EOF CREATE TABLE IF NOT EXISTS products ( id INTEGER PRIMARY KEY, name TEXT NOT NULL, price REAL ); INSERT INTO products (name, price) VALUES (Widget, 19.99), (Gadget, 29.99), (Gizmo, 39.99), (Smart Watch, 199.99), (Wireless Earbuds, 89.99), (Portable Charger, 24.99), (Bluetooth Speaker, 79.99), (Phone Stand, 15.99), (Laptop Sleeve, 34.99), (Mini Drone, 299.99); EOF执行完可以验证一下sqlite3 ~/test.db SELECT COUNT(*) FROM products;正常会输出10。这个数字就是后面 Claude 要帮你查出来的目标值。注意数据库文件路径要记牢配置里会原样用到建议就用~/test.db这种绝对路径别用相对路径否则 Claude 启动 Server 时的工作目录不确定很容易找不到文件。2.2 安装 uv / uvxmcp-server-sqlite官方推荐用uvx直接拉起不用手动 clone 仓库。uvx是uv工具链的一部分# macOS / Linux curl -LsSf https://astral.sh/uv/install.sh | sh # 安装后确认 uvx --version如果uvx --version报 command not found多半是 shell 没重新加载 PATH执行source ~/.zshrc或重开终端即可。Windows 用户可以用powershell -c irm https://astral.sh/uv/install.ps1 | iex。2.3 确认 MCP Server 能独立跑起来在配 Claude 之前先单独验证 Server 本身没问题uvx mcp-server-sqlite --db-path ~/test.db --help能打印出帮助信息说明uvx能拉到包、参数也认。这一步很关键因为如果这里就失败Claude 里配了也是白配。常见失败是网络拉包超时重试一次通常就好。提示mcp-server-sqlite每次通过uvx启动时会检查缓存第一次会稍慢之后启动很快。不要因为它第一次卡住就以为配置错了。到这里数据~/test.db和执行器uvxmcp-server-sqlite都就绪了。接下来才是把它挂到 Claude 上。3. 可复制的 Claude MCP 配置文件claude_desktop_config.json 完整骨架Claude 桌面端读取 MCP Server 的入口是一个 JSON 文件路径因系统而异macOS~/Library/Application Support/Claude/claude_desktop_config.jsonWindows%APPDATA%\Claude\claude_desktop_config.json如果文件不存在就新建。下面是可以直接复制的完整骨架把YOUR_USERNAME换成你的实际用户名{ mcpServers: { sqlite: { command: uvx, args: [ mcp-server-sqlite, --db-path, /Users/YOUR_USERNAME/test.db ] } } }这段配置的含义拆开看mcpServers下每个键这里是sqlite就是你在 Claude 里看到的工具名command是要执行的程序args是传给它的参数数组。--db-path后面必须是一个真实存在的绝对路径。如果你已经有别的 MCP Server不要覆盖而是并列加进去{ mcpServers: { sqlite: { command: uvx, args: [mcp-server-sqlite, --db-path, /Users/YOUR_USERNAME/test.db] }, another-server: { command: uvx, args: [some-other-mcp-server] } } }改完保存完全退出 Claude 再重新打开不是关窗口是退出进程。Claude 启动时才会重新读取这个文件并拉起 Server。重启后在对话框附近能看到工具/连接器图标点开应该能看到sqlite已经列出。注意JSON 不允许注释也不允许末尾多余逗号。很多人复制后报解析失败99% 是多了个逗号或者用了中文引号。建议用编辑器自带的 JSON 校验看一眼。关于模型侧的选择如果你只是偶尔查一下本地库用默认对话模型即可如果要把「查库 写代码 跑脚本」串成长期工作流可以考虑在 TaoToken 的 Coding Plan 里统一管理调用入口省得每个工具单独配 Key。接入文档在 https://taotoken.net/api 有说明模型对话入口在 https://taotoken.net/api-keys 可以拿到 Key 后直接试。配置这一步做完其实还没真正验证。下一节用具体提问把「产品表商品数量」查出来确认整条链路通了。4. 验证请求让 Claude 统计产品表商品数量并核对结果重启 Claude 后新建一个对话直接用自然语言提问。推荐的第一句是用 sqlite 工具查一下 products 表里一共有多少条商品记录。Claude 会做几件事识别到有sqlite这个工具 → 生成一条 SQL通常是SELECT COUNT(*) FROM products;→ 调用工具执行 → 把返回的数字用自然语言告诉你。正常回复类似「products 表中共有 10 条商品记录」。如果它没有自动调用工具可以更明确一点请调用 sqlite MCP 工具执行 SELECT COUNT(*) FROM products告诉我结果。这一步能成功说明配置、路径、Server 全部正确。为了确认不是「碰巧」再补两个验证查询-- 列出所有商品名确认表结构对得上 SELECT name FROM products; -- 按价格区间统计验证聚合能力 SELECT COUNT(*) FROM products WHERE price 50;对应在 Claude 里可以问「列出 products 表所有商品名称」和「价格大于 50 的商品有几个」。前者应返回 10 个名字后者应返回 5Smart Watch、Wireless Earbuds、Bluetooth Speaker、Mini Drone、Portable SSD 之类按你实际数据算。实测下来最容易出问题的是「Claude 说找不到工具」。这时候先别改配置回到终端手动跑一遍uvx mcp-server-sqlite --db-path ~/test.db如果这个命令本身报错问题在环境不在 Claude。如果这个命令正常但 Claude 里没有工具问题在配置文件路径或 JSON 格式。把这两层分开排查效率高很多。验证通过后你其实已经完成了「Claude MCP SQLite 产品表数量统计」的完整闭环。剩下的就是把这条链路用稳。5. 常见报错排查401、local proxy failed、reading choices 与 OAuth 报错这一节按真实会遇到的报错来对。注意SQLite MCP 是纯本地进程正常情况不应该出现鉴权类错误一旦出现说明你把请求打到了远端模型服务而不是本地 Server要分清层次。报错一Error: spawn uvx ENOENT这是 Claude 找不到uvx可执行文件。原因是 Claude 启动时的 PATH 和你终端里的 PATH 不一致。解决办法是用绝对路径先which uvx拿到路径比如/Users/you/.local/bin/uvx然后配置改成{ mcpServers: { sqlite: { command: /Users/you/.local/bin/uvx, args: [mcp-server-sqlite, --db-path, /Users/you/test.db] } } }报错二unable to open database file数据库路径不对或文件不存在。检查--db-path是否指向真实文件且当前用户有读权限。用ls -l ~/test.db确认。报错三401 Unauthorized/invalid api key这个报错和 SQLite MCP 无关通常出现在你把 Claude 的模型请求指向了某个需要 Key 的服务而 Key 没配或配错。如果你在用 TaoToken 作为模型入口去 https://taotoken.net/api-keys 重新生成 Key确认请求头里的 Key 和 Base URL 匹配。Base URL 用 https://taotoken.net/api不要带多余路径。报错四local proxy failed/connection refused说明客户端在往一个本地端口发请求但那个端口没有服务在监听。常见于你配了本地代理但没启动。检查配置里有没有指向127.0.0.1:xxxx的地址确认对应进程在跑。SQLite MCP 本身不走网络端口出现这个基本是模型侧配置串了。报错五error reading choices/ 返回体解析失败一般是上游返回的不是标准 JSON或者被中间层改写了。先确认 Base URL 正确https://taotoken.net/api再确认模型 ID 拼写无误。如果用的是 Claude Code 类工具检查settings.json里的model字段。报错六OAuth 相关报错OAuth token expired/invalid_grant出现在用 OAuth 方式登录的客户端。重新走一次登录授权即可。如果是 Codex 的auth.json场景确认文件里的 token 没过期必要时重新生成。排查顺序建议固定成先手动跑uvx mcp-server-sqlite→ 再看 Claude 配置 JSON → 最后才怀疑模型侧。这样能避免在错误的方向上浪费时间。6. 把这条链路用起来从数量统计到日常数据问答跑通之后真正有价值的是把它变成日常习惯。产品表数量统计只是最小验证你可以顺着问帮我统计 products 表里价格最高的三个商品。 按价格分档统计每个档位的商品数量。 把 products 表里所有商品按价格从高到低列出来。Claude 会自己拼对应的 SQL 去查。你不需要记 SQL 语法但建议偶尔看一眼它生成的语句确认没有误操作比如误删。SQLite MCP Server 默认是能执行写操作的所以别在对话里说「删掉所有商品」这种话除非你确实想删。如果你要把这套能力接到更长的编码/Agent 工作流里比如让 Claude 一边查本地库一边改代码可以考虑用 TaoToken 的 Coding Plan 统一管理模型调用入口在 https://taotoken.net/coding-plan。需要看完整接入说明的文档在 https://taotoken.net/doc。模型对话可以直接在 https://taotoken.net/api-keys 拿 Key 后试。最后给一个实用技巧把常用的查询固化成一个视图比如CREATE VIEW product_stats AS SELECT COUNT(*) AS total FROM products;之后直接问「product_stats 里的 total 是多少」比每次让模型拼聚合 SQL 更稳。数据库文件建议纳入版本管理或定期备份毕竟 MCP 工具能读也能写多一层保险不亏。