旅行规划器配 TaoToken：NestJS+React+SQLite 的 MCP 行程编排骨架

1. 为什么我要自己搭一个旅行规划器旅行规划这件事痛点从来不是想不到去哪而是想到了之后要手动录入到某个 App 里。你让 AI 帮你排一个东京五日游它给你一段漂亮的文字行程然后你得复制、粘贴、拆成一天一天的卡片、填时间、填预算、填备注。中间这个你就是纯纯的搬运工。我想要的形态是AI 直接操作我的行程数据。它拿到我的日程、预算和偏好后通过工具调用把行程写进数据库前端实时刷新出来。这就是 MCPModel Context Protocol的价值——把后端能力暴露成 AI 可调用的工具而不是让 AI 只输出文本。所以这篇要做的是一套最小骨架NestJS 暴露 MCP 工具React 前端展示行程SQLite 落库再通过 TaoToken 统一 Key/API 通道把模型调用接进来。适合谁适合已经会一点 NestJS 和 React、想搞清楚 MCP 到底怎么落地的人。整套东西跑起来不需要 Redis、不需要 PostgreSQL数据就是一个.db文件备份就是cp一下。我试过把这套骨架拆成三块分别验证先让 MCP 工具能被模型调用再让前端能读到数据最后把模型通道换成统一入口。下面按这个顺序来。2. TaoToken 前置统一 Key 与 API 通道在写 MCP 工具之前先把模型调用这条链路理清楚。MCP 服务器本身不产生智能它只是工具的执行端真正决定调哪个工具、传什么参数的是模型。所以你需要一个稳定的模型 API 入口。TaoToken 在这里的角色是统一 Key 和 API 通道你不用为每个模型单独维护一套密钥和 base_url换模型只改一个配置项。官网在 https://taotoken.net/?utm_sourcetaotoken_aicg_blog_endutm_mediumcsdnutm_campaignrewriteutm_content API 入口是 https://taotoken.net/api 这个不加 UTM。你需要先拿到 API Key入口在这里https://taotoken.net/api-keys?utm_sourcetaotoken_aicg_blog_endutm_contentapi_keysutm_campaignrewrite 。拿到之后模型对话调试可以用 https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 接入文档在 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。注意Key 只放在服务端环境变量里不要写进前端代码。React 侧永远只跟自己的 NestJS 后端通信由后端去调模型。如果你后面要做长期编码或者 Agent 类的持续任务可以看 Coding Planhttps://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。控制台在 https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。3. 可复制配置config.toml 与 settings.jsonMCP 服务器的注册方式取决于你用的客户端。下面给两份可直接复制的配置一份是 TOML 风格常见于 Codex 类客户端一份是 JSON 风格常见于 Claude Desktop / Claude Code 类客户端。3.1 config.toml# ~/.codex/config.toml model claude-sonnet-4-20250514 model_provider taotoken [model_providers.taotoken] name TaoToken base_url https://taotoken.net/api env_key TAOTOKEN_API_KEY [mcp_servers.trip_planner] command node args [/absolute/path/to/trip-planner/dist/mcp-server.js] env { TRIP_DB_PATH /absolute/path/to/trip-planner/data/trip.db } startup_timeout_sec 20 tool_timeout_sec 60关键点base_url指向 TaoToken 的 API 入口env_key指定从哪个环境变量读 Key。mcp_servers段里注册的是我们自己的旅行规划器 MCP 服务器command用node直接跑编译产物避免开发期路径混乱。3.2 settings.json{ model: claude-sonnet-4-20250514, env: { TAOTOKEN_API_KEY: sk-your-key-here, ANTHROPIC_BASE_URL: https://taotoken.net/api }, mcpServers: { trip_planner: { command: node, args: [/absolute/path/to/trip-planner/dist/mcp-server.js], env: { TRIP_DB_PATH: /absolute/path/to/trip-planner/data/trip.db } } } }注意ANTHROPIC_BASE_URL这类变量名取决于客户端实现如果你的客户端用的是别的变量名以接入文档为准。核心是 base_url 指向https://taotoken.net/api。Claude Code 场景下还有一份独立配置参考 https://taotoken.net/claude-code-anthropic?utm_sourcetaotoken_aicg_blog_endutm_contentclaude_codeutm_campaignrewrite 。4. NestJS 侧MCP 工具注册代码现在写核心部分。目标是把创建行程添加日程查询行程这三个操作暴露成 MCP 工具。4.1 安装依赖npm i modelcontextprotocol/sdk better-sqlite3 npm i -D types/better-sqlite34.2 SQLite 落库层// src/db.ts import Database from better-sqlite3; const db new Database(process.env.TRIP_DB_PATH ?? ./data/trip.db); db.pragma(journal_mode WAL); db.exec( CREATE TABLE IF NOT EXISTS trips ( id INTEGER PRIMARY KEY AUTOINCREMENT, title TEXT NOT NULL, destination TEXT NOT NULL, budget INTEGER DEFAULT 0, created_at TEXT DEFAULT (datetime(now)) ); CREATE TABLE IF NOT EXISTS itinerary_items ( id INTEGER PRIMARY KEY AUTOINCREMENT, trip_id INTEGER NOT NULL, day_index INTEGER NOT NULL, time_slot TEXT, activity TEXT NOT NULL, cost INTEGER DEFAULT 0, FOREIGN KEY (trip_id) REFERENCES trips(id) ON DELETE CASCADE ); ); export default db;WAL 模式是为了让前端读和 MCP 写不互相阻塞SQLite 单文件也能扛住这种轻量并发。4.3 MCP 工具注册// src/mcp-server.ts import { McpServer } from modelcontextprotocol/sdk/server/mcp.js; import { StdioServerTransport } from modelcontextprotocol/sdk/server/stdio.js; import { z } from zod; import db from ./db; const server new McpServer({ name: trip-planner, version: 0.1.0 }); server.tool( create_trip, 创建一个新的旅行计划返回 trip_id, { title: z.string(), destination: z.string(), budget: z.number().optional() }, async ({ title, destination, budget }) { const info db .prepare(INSERT INTO trips (title, destination, budget) VALUES (?, ?, ?)) .run(title, destination, budget ?? 0); return { content: [{ type: text, text: JSON.stringify({ trip_id: info.lastInsertRowid }) }], }; } ); server.tool( add_itinerary_item, 向指定行程添加一条日程, { trip_id: z.number(), day_index: z.number(), time_slot: z.string().optional(), activity: z.string(), cost: z.number().optional(), }, async ({ trip_id, day_index, time_slot, activity, cost }) { const info db .prepare( INSERT INTO itinerary_items (trip_id, day_index, time_slot, activity, cost) VALUES (?, ?, ?, ?, ?) ) .run(trip_id, day_index, time_slot ?? null, activity, cost ?? 0); return { content: [{ type: text, text: JSON.stringify({ item_id: info.lastInsertRowid }) }], }; } ); server.tool( get_trip, 按 trip_id 查询行程及其全部日程, { trip_id: z.number() }, async ({ trip_id }) { const trip db.prepare(SELECT * FROM trips WHERE id ?).get(trip_id); const items db .prepare(SELECT * FROM itinerary_items WHERE trip_id ? ORDER BY day_index, time_slot) .all(trip_id); return { content: [{ type: text, text: JSON.stringify({ trip, items }) }] }; } ); const transport new StdioServerTransport(); await server.connect(transport);三个工具覆盖了建—填—查闭环。zod负责参数校验模型传错类型会直接被拦下来不会写脏数据。4.4 React 前端读取NestJS 侧再开一个普通 REST 接口给前端用MCP 和 REST 共用同一个db实例// src/trip.controller.ts import { Controller, Get, Param } from nestjs/common; import db from ./db; Controller(api/trips) export class TripController { Get(:id) getTrip(Param(id) id: string) { const trip db.prepare(SELECT * FROM trips WHERE id ?).get(Number(id)); const items db .prepare(SELECT * FROM itinerary_items WHERE trip_id ? ORDER BY day_index) .all(Number(id)); return { trip, items }; } }React 侧一个useEffect拉数据渲染即可这里不展开样式。重点是前端不碰模型、不碰 Key只读自己的后端。5. 验证请求端到端排一次行程配置和代码都就位后做一次完整验证。启动 MCP 服务器TAOTOKEN_API_KEYsk-xxx TRIP_DB_PATH./data/trip.db node dist/mcp-server.js然后在客户端里发一条自然语言指令帮我创建一个东京五日游的行程预算 12000第一天上午去浅草寺下午去晴空塔。预期行为是模型依次调用create_trip和两次add_itinerary_item返回类似{trip_id: 1} {item_id: 1} {item_id: 2}接着验证落库结果sqlite3 ./data/trip.db SELECT * FROM itinerary_items WHERE trip_id 1;你应该看到两条记录day_index都是 1activity分别是浅草寺和晴空塔。再打开前端页面访问/api/trips/1行程卡片正常渲染说明 MCP 写入、SQLite 存储、React 展示这条链路全通了。这一步是整个骨架的验收点如果模型能调工具、数据能落库、前端能显示说明 MCP 集成成功。6. 本篇常见错排查报错Cannot find module better-sqlite3多半是dist目录没重新编译或者node的工作目录不对。MCP 配置里的args用绝对路径别用相对路径。工具调用返回Invalid arguments检查zodschema 和模型传参是否对得上。trip_id必须是 number模型有时会传字符串1可以在 schema 里加.coerce.number()。SQLite 报database is locked确认开了 WAL 模式并且没有两个进程同时以写模式打开同一个文件。MCP 服务器和 NestJS 如果分属两个进程让它们共用同一个db模块或至少都开 WAL。模型不调用工具只输出文本说明 MCP 服务器没被客户端识别。检查config.toml/settings.json里mcp_servers段的名字和启动命令重启客户端后看工具列表里有没有create_trip。base_url 配错导致 401确认指向的是https://taotoken.net/apiKey 从环境变量读取而不是硬编码。接入细节对照 https://taotoken.net/doc?utm_sourcetaotoken_aicg_blog_endutm_contentdocutm_campaignrewrite 。排障过程中如果怀疑是 Key 或通道问题可以先用模型对话页面单独验证一次调用https://taotoken.net/models?utm_sourcetaotoken_aicg_blog_endutm_contentmodelsutm_campaignrewrite 。确认通道没问题再回来查 MCP 配置。7. 把通道固定下来骨架就能复用这套骨架跑通之后你会发现真正需要反复调的只有两处MCP 工具的参数 schema和模型通道的配置。前者决定 AI 能做什么后者决定 AI 能不能稳定地做。把 Key 和 base_url 统一到 TaoToken 之后换模型不用改业务代码MCP 工具注册那部分也完全不用动。后面想加生成打包清单标记已访问城市这类工具照着server.tool的模式往下写就行数据库加张表、前端加个接口链路是现成的。长期做编码或 Agent 任务的话Coding Plan 那条通道更适合持续调用https://taotoken.net/coding-plan?utm_sourcetaotoken_aicg_blog_endutm_contentcoding_planutm_campaignrewrite 。日常调试和 Key 管理走控制台https://taotoken.net/console?utm_sourcetaotoken_aicg_blog_endutm_contentconsoleutm_campaignrewrite 。