告别海外账号与网络限制稳定直连全球优质大模型限时半价接入中。 点击领取海量免费额度1. 先把目标定清楚让 Claude Code 真的能查 SQLite这篇要解决的事情很具体在 Claude Code 里挂上mcp-server-sqlite然后用一句自然语言让它去查一个本地 SQLite 数据库最后拿到真实的查询结果。不是演示概念是跑通一条完整链路。适合谁看已经在用 Claude Code、想给它加数据库查询能力的人或者刚接触 MCPModel Context Protocol生态想找一个最小可跑通的例子。MCP 你可以理解成 Claude Code 的“外挂接口协议”它让模型能调用外部工具而mcp-server-sqlite就是其中一个现成的工具服务专门负责读写 SQLite。整条链路有三段模型供应商TaoToken、Claude Code 本体、MCP 工具服务sqlite。三段都通了你才能在对话框里说“帮我查一下 users 表里有多少条记录”然后它真的去执行 SQL 并把结果贴回来。我试过把这个流程拆成可复现的步骤下面按顺序来。先准备 Key 和供应商配置再装 MCP 服务最后验证查询。每一步都有完整命令你照着敲就行。2. 准备 Key 与模型供应商配置2.1 创建 API Key先到 TaoToken 官网创建一把 Key。入口在这里https://taotoken.net/?utm_sourcetaotoken_aicg_blog_generateutm_mediumcsdnutm_campaigngenerateutm_content登录后进控制台找到 API Keys 页面新建一把。建议给这把 Key 起个能认出来的名字比如claude-code-sqlite方便以后区分用途。创建完立刻复制保存页面刷新后通常就不再完整显示了。控制台直达链接带 utm_campaigngeneratehttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_generateutm_mediumcsdnutm_campaigngenerateutm_contentAPI Keys 页面直达https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_generateutm_mediumcsdnutm_campaigngenerateutm_content2.2 把 TaoToken 设为 Claude Code 的模型供应商Claude Code 通过环境变量读取供应商地址和 Key。TaoToken 的 API 根地址是https://taotoken.net/api注意这个地址不带任何 UTM 参数配置里就用这个干净的根地址。设置方式有两种选一种即可。方式一写进 shell 配置文件推荐长期生效。以 zsh 为例编辑~/.zshrcexport ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你刚才创建的Key保存后执行source ~/.zshrc让它生效。如果你用 bash就改~/.bashrc逻辑一样。方式二临时在当前终端会话里设置适合只想试一次export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你刚才创建的Key设置完可以验证一下变量有没有生效echo $ANTHROPIC_BASE_URL应该输出https://taotoken.net/api。如果输出为空说明没写进当前会话检查一下是不是漏了source。注意Key 属于敏感信息别直接提交到 Git 仓库。如果配置文件会被同步或分享建议用单独的本地文件管理或者至少确认.zshrc不在版本控制里。这一步做完Claude Code 的模型请求就会走 TaoToken。你可以先启动一次claude确认能正常对话再往下装 MCP 服务。3. 安装并挂载 mcp-server-sqlite3.1 确认前置环境mcp-server-sqlite是一个基于 Node 的 MCP 服务通常通过npx直接拉起不需要全局安装。先确认本机有 Node 和 npxnode -v npx -v两个命令都能输出版本号就行。如果npx报找不到说明 Node 装得不完整重装一个 LTS 版本即可。3.2 用 claude mcp add 添加 sqlite 服务Claude Code 提供了claude mcp add命令来注册 MCP 服务。核心是把启动命令和数据库文件路径传进去。假设你的数据库文件放在/Users/you/data/demo.db命令长这样claude mcp add sqlite -- npx -y modelcontextprotocol/server-sqlite /Users/you/data/demo.db拆解一下这段命令sqlite是你给这个服务起的名字后面--之后是实际执行的启动命令。npx -y表示自动确认下载modelcontextprotocol/server-sqlite是包名最后的路径是数据库文件。如果你还没有数据库文件可以先造一个用来测试sqlite3 /Users/you/data/demo.db CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT, city TEXT); INSERT INTO users (name, city) VALUES (Alice, Shanghai), (Bob, Beijing), (Carol, Shenzhen);这条命令建了一张users表并插入三条记录。没有sqlite3命令行工具的话用任何 SQLite 客户端建库都行关键是文件路径要和上面claude mcp add里写的一致。3.3 确认服务已注册添加完可以列出当前注册的 MCP 服务claude mcp list输出里应该能看到sqlite这一项状态是已连接或可用。如果显示连接失败多半是路径写错或者包名拼错回头核对一下。提示不同版本的 Claude Code 在mcp add的参数细节上可能略有差异如果上面的写法报参数错误用claude mcp add --help看一下当前版本支持的格式按提示调整。4. 在 Claude Code 里执行一次真实查询4.1 启动并触发查询环境和服务都就绪后进入项目目录启动 Claude Codeclaude然后在对话框里直接用自然语言提问比如用 sqlite 工具查一下 users 表里所有记录按 id 排序Claude Code 会识别到有 sqlite 这个 MCP 工具可用自动构造 SQL 并调用。它实际执行的语句大致是SELECT * FROM users ORDER BY id;4.2 一次查询返回结果样例执行成功后返回内容类似下面这样具体格式会随版本略有不同id | name | city ---|-------|--------- 1 | Alice | Shanghai 2 | Bob | Beijing 3 | Carol | Shenzhen 共 3 行记录。看到这个结果说明整条链路通了Claude Code 通过 TaoToken 拿到模型能力模型决定调用 sqlite 工具工具真的读了本地数据库文件并返回数据。你也可以换个问法验证它是不是真的在查库比如统计 users 表里每个 city 有多少人它应该返回类似Shanghai: 1, Beijing: 1, Shenzhen: 1的聚合结果。如果两次查询结果都对得上你插入的数据那基本可以确认不是模型在编。4.3 常见失败分支查询没成功时按下面几个方向排查。第一种模型请求就失败报 401 或鉴权错误。这通常是ANTHROPIC_API_KEY没设对或者 Key 已失效。重新echo $ANTHROPIC_API_KEY确认必要时回控制台新建一把。第二种claude mcp list里 sqlite 显示未连接。检查数据库文件路径是否存在、是否有读权限以及npx能不能正常拉包。可以手动跑一次启动命令看报错npx -y modelcontextprotocol/server-sqlite /Users/you/data/demo.db如果这行就报错问题在服务本身跟 Claude Code 无关。第三种模型能对话但就是不调用 sqlite 工具。可能是提问太模糊明确说“用 sqlite 工具”通常能触发。也可能是服务没被正确加载重启一次 Claude Code 再试。第四种查询报“no such table”。说明连上了库但表名不对用sqlite3 demo.db .tables确认实际表名。5. 限制、成本与模型选择mcp-server-sqlite默认对数据库文件有读写能力这意味着模型理论上可以执行INSERT、UPDATE甚至DROP。生产库千万别直接挂上去用只读副本或者测试库更稳妥。如果服务本身支持只读模式参数优先开启。成本方面每次查询都会消耗模型 token具体计费以 TaoToken 官网当前说明为准。查询本身很轻但如果你让它做复杂分析、多轮追问token 会累积。想控制成本可以把问题问得具体一点减少来回。模型选择上简单的单表查询用轻量模型就够复杂 join 或多步推理再换更强的模型。TaoToken 支持的具体模型清单和可用性以官网和控制台里实际列出的为准别照搬别处的型号。长期高频使用的话可以了解一下 Coding Plan 这类方案入口在这里https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_generateutm_mediumcsdnutm_campaigngenerateutm_content接入过程中遇到配置问题文档页有更细的说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_generateutm_mediumcsdnutm_campaigngenerateutm_content最后补一个实用习惯把claude mcp add那条命令记在项目的 README 或笔记里。换机器、重装环境时一条命令就能把 sqlite 服务重新挂上不用再回忆参数顺序。数据库路径建议用绝对路径相对路径在不同工作目录下启动时容易找不到文件这是我自己踩过的坑。 告别海外账号与网络限制稳定直连全球优质大模型限时半价接入中。 点击领取海量免费额度
10 分钟用 TaoToken 跑通 Claude Code 的 mcp-server-sqlite
告别海外账号与网络限制稳定直连全球优质大模型限时半价接入中。 点击领取海量免费额度1. 先把目标定清楚让 Claude Code 真的能查 SQLite这篇要解决的事情很具体在 Claude Code 里挂上mcp-server-sqlite然后用一句自然语言让它去查一个本地 SQLite 数据库最后拿到真实的查询结果。不是演示概念是跑通一条完整链路。适合谁看已经在用 Claude Code、想给它加数据库查询能力的人或者刚接触 MCPModel Context Protocol生态想找一个最小可跑通的例子。MCP 你可以理解成 Claude Code 的“外挂接口协议”它让模型能调用外部工具而mcp-server-sqlite就是其中一个现成的工具服务专门负责读写 SQLite。整条链路有三段模型供应商TaoToken、Claude Code 本体、MCP 工具服务sqlite。三段都通了你才能在对话框里说“帮我查一下 users 表里有多少条记录”然后它真的去执行 SQL 并把结果贴回来。我试过把这个流程拆成可复现的步骤下面按顺序来。先准备 Key 和供应商配置再装 MCP 服务最后验证查询。每一步都有完整命令你照着敲就行。2. 准备 Key 与模型供应商配置2.1 创建 API Key先到 TaoToken 官网创建一把 Key。入口在这里https://taotoken.net/?utm_sourcetaotoken_aicg_blog_generateutm_mediumcsdnutm_campaigngenerateutm_content登录后进控制台找到 API Keys 页面新建一把。建议给这把 Key 起个能认出来的名字比如claude-code-sqlite方便以后区分用途。创建完立刻复制保存页面刷新后通常就不再完整显示了。控制台直达链接带 utm_campaigngeneratehttps://taotoken.net/console?utm_sourcetaotoken_aicg_blog_generateutm_mediumcsdnutm_campaigngenerateutm_contentAPI Keys 页面直达https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_generateutm_mediumcsdnutm_campaigngenerateutm_content2.2 把 TaoToken 设为 Claude Code 的模型供应商Claude Code 通过环境变量读取供应商地址和 Key。TaoToken 的 API 根地址是https://taotoken.net/api注意这个地址不带任何 UTM 参数配置里就用这个干净的根地址。设置方式有两种选一种即可。方式一写进 shell 配置文件推荐长期生效。以 zsh 为例编辑~/.zshrcexport ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你刚才创建的Key保存后执行source ~/.zshrc让它生效。如果你用 bash就改~/.bashrc逻辑一样。方式二临时在当前终端会话里设置适合只想试一次export ANTHROPIC_BASE_URLhttps://taotoken.net/api export ANTHROPIC_API_KEY你刚才创建的Key设置完可以验证一下变量有没有生效echo $ANTHROPIC_BASE_URL应该输出https://taotoken.net/api。如果输出为空说明没写进当前会话检查一下是不是漏了source。注意Key 属于敏感信息别直接提交到 Git 仓库。如果配置文件会被同步或分享建议用单独的本地文件管理或者至少确认.zshrc不在版本控制里。这一步做完Claude Code 的模型请求就会走 TaoToken。你可以先启动一次claude确认能正常对话再往下装 MCP 服务。3. 安装并挂载 mcp-server-sqlite3.1 确认前置环境mcp-server-sqlite是一个基于 Node 的 MCP 服务通常通过npx直接拉起不需要全局安装。先确认本机有 Node 和 npxnode -v npx -v两个命令都能输出版本号就行。如果npx报找不到说明 Node 装得不完整重装一个 LTS 版本即可。3.2 用 claude mcp add 添加 sqlite 服务Claude Code 提供了claude mcp add命令来注册 MCP 服务。核心是把启动命令和数据库文件路径传进去。假设你的数据库文件放在/Users/you/data/demo.db命令长这样claude mcp add sqlite -- npx -y modelcontextprotocol/server-sqlite /Users/you/data/demo.db拆解一下这段命令sqlite是你给这个服务起的名字后面--之后是实际执行的启动命令。npx -y表示自动确认下载modelcontextprotocol/server-sqlite是包名最后的路径是数据库文件。如果你还没有数据库文件可以先造一个用来测试sqlite3 /Users/you/data/demo.db CREATE TABLE users (id INTEGER PRIMARY KEY, name TEXT, city TEXT); INSERT INTO users (name, city) VALUES (Alice, Shanghai), (Bob, Beijing), (Carol, Shenzhen);这条命令建了一张users表并插入三条记录。没有sqlite3命令行工具的话用任何 SQLite 客户端建库都行关键是文件路径要和上面claude mcp add里写的一致。3.3 确认服务已注册添加完可以列出当前注册的 MCP 服务claude mcp list输出里应该能看到sqlite这一项状态是已连接或可用。如果显示连接失败多半是路径写错或者包名拼错回头核对一下。提示不同版本的 Claude Code 在mcp add的参数细节上可能略有差异如果上面的写法报参数错误用claude mcp add --help看一下当前版本支持的格式按提示调整。4. 在 Claude Code 里执行一次真实查询4.1 启动并触发查询环境和服务都就绪后进入项目目录启动 Claude Codeclaude然后在对话框里直接用自然语言提问比如用 sqlite 工具查一下 users 表里所有记录按 id 排序Claude Code 会识别到有 sqlite 这个 MCP 工具可用自动构造 SQL 并调用。它实际执行的语句大致是SELECT * FROM users ORDER BY id;4.2 一次查询返回结果样例执行成功后返回内容类似下面这样具体格式会随版本略有不同id | name | city ---|-------|--------- 1 | Alice | Shanghai 2 | Bob | Beijing 3 | Carol | Shenzhen 共 3 行记录。看到这个结果说明整条链路通了Claude Code 通过 TaoToken 拿到模型能力模型决定调用 sqlite 工具工具真的读了本地数据库文件并返回数据。你也可以换个问法验证它是不是真的在查库比如统计 users 表里每个 city 有多少人它应该返回类似Shanghai: 1, Beijing: 1, Shenzhen: 1的聚合结果。如果两次查询结果都对得上你插入的数据那基本可以确认不是模型在编。4.3 常见失败分支查询没成功时按下面几个方向排查。第一种模型请求就失败报 401 或鉴权错误。这通常是ANTHROPIC_API_KEY没设对或者 Key 已失效。重新echo $ANTHROPIC_API_KEY确认必要时回控制台新建一把。第二种claude mcp list里 sqlite 显示未连接。检查数据库文件路径是否存在、是否有读权限以及npx能不能正常拉包。可以手动跑一次启动命令看报错npx -y modelcontextprotocol/server-sqlite /Users/you/data/demo.db如果这行就报错问题在服务本身跟 Claude Code 无关。第三种模型能对话但就是不调用 sqlite 工具。可能是提问太模糊明确说“用 sqlite 工具”通常能触发。也可能是服务没被正确加载重启一次 Claude Code 再试。第四种查询报“no such table”。说明连上了库但表名不对用sqlite3 demo.db .tables确认实际表名。5. 限制、成本与模型选择mcp-server-sqlite默认对数据库文件有读写能力这意味着模型理论上可以执行INSERT、UPDATE甚至DROP。生产库千万别直接挂上去用只读副本或者测试库更稳妥。如果服务本身支持只读模式参数优先开启。成本方面每次查询都会消耗模型 token具体计费以 TaoToken 官网当前说明为准。查询本身很轻但如果你让它做复杂分析、多轮追问token 会累积。想控制成本可以把问题问得具体一点减少来回。模型选择上简单的单表查询用轻量模型就够复杂 join 或多步推理再换更强的模型。TaoToken 支持的具体模型清单和可用性以官网和控制台里实际列出的为准别照搬别处的型号。长期高频使用的话可以了解一下 Coding Plan 这类方案入口在这里https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_generateutm_mediumcsdnutm_campaigngenerateutm_content接入过程中遇到配置问题文档页有更细的说明https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_generateutm_mediumcsdnutm_campaigngenerateutm_content最后补一个实用习惯把claude mcp add那条命令记在项目的 README 或笔记里。换机器、重装环境时一条命令就能把 sqlite 服务重新挂上不用再回忆参数顺序。数据库路径建议用绝对路径相对路径在不同工作目录下启动时容易找不到文件这是我自己踩过的坑。 告别海外账号与网络限制稳定直连全球优质大模型限时半价接入中。 点击领取海量免费额度
代码包深度解析与实践指南)
