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

发布时间：2026/9/26 4:00:53

旅行规划器配 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 。

相关新闻

Python垃圾分类系统落地实战：从数据清洗到边缘部署

Python垃圾分类系统落地实战：从数据清洗到边缘部署

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/26 4:00:53 阅读更多 →
一文读懂如何给Claude桌面软件添加MCP服务器：TaoToken统一Key接入与config.toml配置实战

一文读懂如何给Claude桌面软件添加MCP服务器：TaoToken统一Key接入与config.toml配置实战

/* MD / 富文本中的 .toc（含博客园搬家等嵌套结构）；.toc-box 在侧栏，不受影响 */#content_views .toc,/* 编辑器常在目录前后插入空 p（:empty 仍占 20px），一并去掉避免顶空隙 */#content_views.markdown_views > p:empty:has(+ .toc),#content_views.markdown_views …

2026/9/26 3:59:53 阅读更多 →
MobileNetV3电子垃圾识别实战：轻量模型适配真实产线图像

MobileNetV3电子垃圾识别实战：轻量模型适配真实产线图像

简介：本资源是一套面向高校毕业设计与课程设计场景的电子垃圾图像识别完整实现方案，聚焦深度学习轻量化模型落地实践，解决环保领域电子废弃物智能分类的实际需求。项目基于MobileNetV3架构构建端侧友好型识别系统，涵盖原理剖析、数…

2026/9/26 3:59:53 阅读更多 →

最新新闻

无人机视角交通目标检测数据集与实战调优指南

无人机视角交通目标检测数据集与实战调优指南

简介：本资源是面向计算机视觉算法工程师与智能交通系统开发者的专业级YOLO格式目标检测数据集，专为解决高空视角下多类交通工具识别难题而构建。数据集包含956张训练图与169张验证图，覆盖bus、car、van、mot、sea、bis、kam、ins、ismak共9类…

2026/9/26 4:44:18 阅读更多 →
Raft 与 Paxos 的异同与工程化选型：从规范到实现清单

Raft 与 Paxos 的异同与工程化选型：从规范到实现清单

Raft 与 Paxos 的异同与工程化选型：从规范到实现清单在分布式强一致性共识协议的浩瀚星空中，Paxos（Leslie Lamport 提出）被公认为分布式共识的理论鼻祖与数学奠基石，而 Raft（Diego Ongaro 提出）…

2026/9/26 4:44:18 阅读更多 →
TS码流分析实战：PAT/PMT/PCR结构解析与播放排障

TS码流分析实战：PAT/PMT/PCR结构解析与播放排障

简介：一款专为TS流结构学习与广电故障排查设计的码流分析软件，以树形视图完整呈现节目关联表（PAT）、节目映射表（PMT）、业务描述表（SDT）、事件信息表（EIT）及字…

2026/9/26 4:44:18 阅读更多 →
openclaw实战：用LLM代理搭建自主教育游戏开发流水线

openclaw实战：用LLM代理搭建自主教育游戏开发流水线

开头最近一个月，我基本把全部业余时间都压在了同一件事上：用 openclaw 搭一条 Autonomous Educational Game Development Pipeline，让 LLM 代理自主完成"从需求到可试玩教育游戏"的整个链路。这期间最让我上头的不是生成的游戏本身…

2026/9/26 4:44:18 阅读更多 →
Windows下MinGW-w64免安装版配置与GCC编译实战

Windows下MinGW-w64免安装版配置与GCC编译实战

简介：一份已在Windows 64位环境下亲测可用的MingW64编译器工具集，面向需要在Windows平台编写C、C或Fortran程序的开发者，可直接解压启用，免去官方安装流程的配置困扰，也适合作为便携式GCC环境随用随取。压缩包共3125个…

2026/9/26 4:44:18 阅读更多 →
在Windows XP上轻松实现4K分辨率：三条实操路线与关键排查指南

在Windows XP上轻松实现4K分辨率：三条实操路线与关键排查指南

“World‘s First Release”这个抬头放在“在XP系统上打开4K分辨率”这件事上，说实话有点夸张。这活儿我在老机器上反复折腾过，Windows XP从设计之初就没为4K准备过——驱动停更、没有DPI缩放、视频硬解基本指望CPU，但它又偏偏还活在不少工控…

2026/9/26 4:43:18 阅读更多 →

日新闻

数据库课后习题答案别硬背：当测试用例集刷，效率翻倍

数据库课后习题答案别硬背：当测试用例集刷，效率翻倍

简介：万常选版《数据库原理与设计》课后习题答案资源，覆盖第2至6章及第9章，适合正在学习关系模型、数据库建模、关系数据理论与模式求精的本科生、自学者作为复习与自测材料。压缩包共7个文件，含3个doc参考答案、2个sql示例脚本、…

2026/9/26 0:00:25 阅读更多 →
学校官网模拟全流程实践：从页面布局到后端接口与部署

学校官网模拟全流程实践：从页面布局到后端接口与部署

如果你正在找一门 Web 大作业的题目，或者刚开始接触 Web 前端开发想做点能拿来展示的东西，“学校官网模拟”几乎是最稳的选择。题目看着简单，但要把导航、新闻列表、轮播 Banner、二级页面、后台数据都串起来，其实已经把前端布局、…

2026/9/26 0:00:25 阅读更多 →
超级玛丽游戏源码C++：从零搭建横版跳跃游戏工程

超级玛丽游戏源码C++：从零搭建横版跳跃游戏工程

简介：这是一份面向游戏开发初学者与C进阶学习者的超级玛丽（超级马里奥）游戏源码，基于C面向对象编程实现，适合想通过经典项目理解游戏主循环、角色类设计、地图关卡加载与物理碰撞检测的读者参考。压缩包共49个文件&…

2026/9/26 0:00:25 阅读更多 →

周新闻

Flutter for OpenHarmony游戏卡片渐变背景实战：从原理到性能优化

Flutter for OpenHarmony游戏卡片渐变背景实战：从原理到性能优化

直接铺开项目本身吧。这几个月我一直在折腾一件事：用Flutter给OpenHarmony做一款游戏集合类的App，说白了就是把若干小游戏塞进一个壳里，用统一入口分发。这个方向本身不算新鲜，真正让我花了不少心思的，是首页那堆游戏卡…

2026/9/25 19:27:14 阅读更多 →
Word表格编号全攻略：从列表编号到题注交叉引用

Word表格编号全攻略：从列表编号到题注交叉引用

写Word文档，最让人头疼的往往是那些“看起来不起眼”的小问题。比如表格编号这事：今天在表后面多加了两个空白行，明天给客户交稿前发现整个章节的编号全部错位，光是挨个改序号就能耗掉大半个下午。我前阵子帮人整理一份上百页的技…

2026/9/25 11:15:26 阅读更多 →
从第一个站到第二个站：独立开发者的静态网站选型与落地实践

从第一个站到第二个站：独立开发者的静态网站选型与落地实践

1. 项目概述1.1 核心需求解析做独立开发者这几年，说实话，第一个网站上线的那天晚上我兴奋得没睡着。但等它跑了半年，流量惨淡、功能臃肿、代码自己都懒得看第二遍之后，我才慢慢琢磨明白一个道理：第一个网站是练手&…

2026/9/25 20:29:09 阅读更多 →

月新闻

持续集成 流水线自动化与 声明式交付 实践：原型怎样变成可用功能

持续集成 流水线自动化与 声明式交付 实践：原型怎样变成可用功能

持续集成 流水线自动化与 声明式交付 实践：原型怎样变成可用功能分类：[AI/大模型]细分主题：AI 增强型 CI/CD 流水线自动化与 GitOps 实践：Agent 工作流、工具调用与任务拆解：从原型到生产的验收清单很多团队在尝试用大…

2026/9/25 20:29:43 阅读更多 →
容器编排 生产环境运维与排障实战：复盘记录怎样真正派上用场

容器编排 生产环境运维与排障实战：复盘记录怎样真正派上用场

容器编排 生产环境运维与排障实战：复盘记录怎样真正派上用场分类：[工程技术]细分主题：Kubernetes 生产环境运维与排障实战：可复制的项目复盘模板与决策记录大部分团队的事故复盘报告，最后都变成了躺在 Confluence 或钉…

2026/9/25 20:29:31 阅读更多 →
容器 容器化技术与镜像安全管理：核心链路应该先拆哪一步

容器 容器化技术与镜像安全管理：核心链路应该先拆哪一步

容器 容器化技术与镜像安全管理：核心链路应该先拆哪一步分类：[工程技术]细分主题：Docker 容器化技术与镜像安全管理：核心链路的逐步实现与关键代码取舍面对一个积累了五六年历史包袱的单体架构应用（包含 Web 接口、后台…

2026/9/25 19:27:26 阅读更多 →