[{"data":1,"prerenderedAt":2201},["ShallowReactive",2],{"docs-navigation-zh-CN":3,"mdc--tctnej-key":338,"docs--docs-ai-mcp":351,"surround--docs-ai-mcp":2190,"-docs-ai-mcp-description":2193},[4],{"title":5,"path":6,"stem":7,"children":8,"page":113},"Docs","\u002Fdocs","docs",[9,38,114,150,191,239],{"title":10,"path":11,"stem":12,"children":13,"category":16,"description":16,"icon":37},"开始","\u002Fdocs\u002Fgetting-started","docs\u002F1.getting-started\u002F1.index",[14,19,25,31],{"title":15,"path":11,"stem":12,"category":16,"description":17,"icon":18},"简介",null,"Movk Nuxt Docs 是一个可以直接 extends 的 Nuxt Layer，提供文档站所需的排版、导航、搜索、SEO 与 AI 能力。本页说明它适合什么项目、默认包含哪些功能、哪些功能按需开启。","i-lucide-book-open",{"title":20,"path":21,"stem":22,"category":16,"description":23,"icon":24},"安装","\u002Fdocs\u002Fgetting-started\u002Finstallation","docs\u002F1.getting-started\u002F2.installation","用官方模板从零创建文档站，或把 @movk\u002Fnuxt-docs 作为 Layer 接入现有 Nuxt 项目。本页列出 default、i18n、module 三套模板的区别、运行环境要求与必须安装的依赖。","i-lucide-download",{"title":26,"path":27,"stem":28,"category":16,"description":29,"icon":30},"项目结构","\u002Fdocs\u002Fgetting-started\u002Fproject-structure","docs\u002F1.getting-started\u002F3.project-structure","说明使用 Movk Nuxt Docs 的项目中各目录与文件的职责：内容放在哪里、路由如何生成、哪些文件会被自动识别为版本发布页与案例页，以及两份配置文件分别管什么。","i-lucide-folder-tree",{"title":32,"path":33,"stem":34,"category":16,"description":35,"icon":36},"从 v2 迁移","\u002Fdocs\u002Fgetting-started\u002Fmigration","docs\u002F1.getting-started\u002F4.migration","逐条列出从 @movk\u002Fnuxt-docs v2 升级到 v3 的破坏性变更，每项给出 v2 与 v3 写法对比。按顺序检查依赖与功能开关、内容目录、配置字段、视觉默认值和组件覆盖，即可完成升级。","i-lucide-arrow-right-left","i-lucide-square-play",{"title":39,"category":16,"description":16,"icon":40,"path":41,"stem":42,"children":43,"page":113},"指南","i-lucide-compass","\u002Fdocs\u002Fguide","docs\u002F2.guide",[44,51,58,64,70,76,82,89,95,101,107],{"title":45,"path":46,"stem":47,"category":48,"description":49,"icon":50},"配置总览","\u002Fdocs\u002Fguide\u002Fconfiguration","docs\u002F2.guide\u002F1.configuration","basics","Movk Nuxt Docs 的配置分为 nuxt.config.ts 与 app.config.ts 两处：前者在构建期决定启用哪些模块与功能，后者在运行时控制界面、文案与导航。本页说明两者的分工、生效时机，以及常见需求应该改哪一处。","i-lucide-settings",{"title":52,"path":53,"stem":54,"category":55,"description":56,"icon":57},"故障排查","\u002Fdocs\u002Fguide\u002Ftroubleshooting","docs\u002F2.guide\u002F10.troubleshooting","shipping","汇总可选依赖缺失、AI Chat 与 MCP 依赖关系、文档 404、多语言配置、pnpm 构建脚本审批与提交记录问题的解决办法。","i-lucide-life-buoy",{"title":59,"path":60,"stem":61,"category":55,"description":62,"icon":63},"常见问题","\u002Fdocs\u002Fguide\u002Ffaq","docs\u002F2.guide\u002F11.faq","关于 Movk Nuxt Docs 的常见疑问：与 Nuxt UI 文档模板的关系、包管理器与 Node.js 版本、单语言站点、关闭 GitHub 集成、接入其他 AI 厂商、升级与组件覆盖、静态部署的限制等，每条都链接到详细说明。","i-lucide-circle-help",{"title":65,"path":66,"stem":67,"category":48,"description":68,"icon":69},"主题与字体","\u002Fdocs\u002Fguide\u002Ftheme","docs\u002F2.guide\u002F2.theme","默认主题采用编辑风：暖灰纸面、朱红强调色、衬线标题与等宽元信息。本页说明默认配色与字体、如何通过 app.config 切换颜色与标题字体、引入中文衬线字体，以及访客主题面板与动效偏好的行为。","i-lucide-palette",{"title":71,"path":72,"stem":73,"category":48,"description":74,"icon":75},"导航与分类","\u002Fdocs\u002Fguide\u002Fnavigation","docs\u002F2.guide\u002F3.navigation","页头导航、移动端菜单与侧栏分组都在 app.config 中声明，文档目录结构则决定栏目条与侧栏的内容和顺序。本页说明各类导航的数据来源、多语言文案与链接前缀、侧栏分组规则，以及导航过滤与 ⌘K 搜索。","i-lucide-map",{"title":77,"path":78,"stem":79,"category":48,"description":80,"icon":81},"功能开关","\u002Fdocs\u002Fguide\u002Ffeatures","docs\u002F2.guide\u002F4.features","组件文档、Mermaid、AI Chat、无障碍检查等可选功能都由 nuxt.config 中的开关控制，默认关闭的功能不会打包任何相关依赖。本页列出每个开关的默认值、启用后需要安装的依赖，以及关闭时的降级行为。","i-lucide-toggle-right",{"title":83,"path":84,"stem":85,"category":86,"description":87,"icon":88},"自定义","\u002Fdocs\u002Fguide\u002Fcustomization","docs\u002F2.guide\u002F5.customization","customization","在项目组件目录中创建与内置组件同名的 Vue 文件，即可替换页头、侧栏、页脚等界面区域。本页列出 v3 承诺稳定的可覆盖组件、各自的挂载位置，并为每个组件给出最小覆盖示例。","i-lucide-paintbrush",{"title":90,"path":91,"stem":92,"category":86,"description":93,"icon":94},"页面与布局","\u002Fdocs\u002Fguide\u002Fpages","docs\u002F2.guide\u002F6.pages","除文档页外，Layer 会根据 content 目录中的文件自动生成首页、版本发布页与案例页，你也可以在 app\u002Fpages 中编写任意 Vue 页面。本页说明各内置路由的生成条件与内容格式、自定义页面的页头页脚开关，以及内置布局。","i-lucide-layout-panel-top",{"title":96,"path":97,"stem":98,"category":86,"description":99,"icon":100},"国际化","\u002Fdocs\u002Fguide\u002Fi18n","docs\u002F2.guide\u002F7.i18n","用 @nuxtjs\u002Fi18n 为文档站开启多语言：安装与配置、内容目录约定、按语言生成的内容集合、界面文案覆盖与 hreflang SEO。未配置时站点按单语言运行，也可只切换界面语言。","i-lucide-languages",{"title":102,"path":103,"stem":104,"category":86,"description":105,"icon":106},"OG 图片","\u002Fdocs\u002Fguide\u002Fog-image","docs\u002F2.guide\u002F8.og-image","每个文档页在构建时自动生成社交分享图片（OG 图片）。本页说明内置模板读取哪些字段、如何在自定义页面中生成、如何替换模板，以及关闭该功能后的行为。","i-lucide-image",{"title":108,"path":109,"stem":110,"category":55,"description":111,"icon":112},"部署","\u002Fdocs\u002Fguide\u002Fdeployment","docs\u002F2.guide\u002F9.deployment","把文档站部署到 Vercel、Netlify、Cloudflare 或任意 Node.js 服务器，也可以生成纯静态站点。本页列出构建命令、环境变量、各平台的注意事项，以及静态部署下不可用的功能。","i-lucide-rocket",false,{"title":115,"category":16,"description":16,"icon":116,"path":117,"stem":118,"children":119,"page":113},"AI","i-lucide-sparkles","\u002Fdocs\u002Fai","docs\u002F3.ai",[120,126,132,138,144],{"title":121,"path":122,"stem":123,"category":16,"description":124,"icon":125},"AI Chat","\u002Fdocs\u002Fai\u002Fai-chat","docs\u002F3.ai\u002F1.ai-chat","为文档站启用内置 AI 助手：说明启用条件与依赖安装、模型与端点路由的配置方式、如何接入其他厂商，以及组件与组合式函数的 API，帮助你在几分钟内让读者直接向文档提问。","i-lucide-bot",{"title":127,"path":128,"stem":129,"category":16,"description":130,"icon":131},"MCP Server","\u002Fdocs\u002Fai\u002Fmcp","docs\u002F3.ai\u002F2.mcp","每个文档站默认在 \u002Fmcp 提供 Model Context Protocol 服务。本页列出内置的工具、资源与提示词，说明如何在 Claude Code、Cursor、VS Code 等客户端接入，以及如何关闭、限制或扩展服务器。","i-lucide-plug",{"title":133,"path":134,"stem":135,"category":16,"description":136,"icon":137},"Agent Skills","\u002Fdocs\u002Fai\u002Fskills","docs\u002F3.ai\u002F3.skills","把项目根目录 skills\u002F 下的 Agent Skills 随文档站一起发布到 \u002F.well-known\u002Fskills\u002F，读者一条命令即可安装到 Claude Code、Cursor 等助手。本页说明目录结构、命名规则、发布方式与内置的两个 Skill。","i-lucide-wand-sparkles",{"title":139,"path":140,"stem":141,"category":16,"description":142,"icon":143},"llms.txt","\u002Fdocs\u002Fai\u002Fllms-txt","docs\u002F3.ai\u002F4.llms-txt","文档站自动生成 \u002Fllms.txt 与 \u002Fllms-full.txt，为大语言模型提供站点目录与全文。本页说明默认值从哪里来、如何配置标题与分组、它们与每页 Markdown 表示的关系，以及在 Cursor 等工具中的用法。","i-lucide-file-text",{"title":145,"path":146,"stem":147,"category":16,"description":148,"icon":149},"代理发现","\u002Fdocs\u002Fai\u002Fagent-discovery","docs\u002F3.ai\u002F5.agent-discovery","文档站默认为 AI 代理提供每页的 Markdown 表示、Markdown 站点地图与一组 \u002F.well-known 发现文档，代理无需解析 HTML 就能找到并读取内容。本页列出全部端点、内容协商规则与 layer 的补充实现。","i-lucide-radar",{"title":151,"category":16,"description":16,"icon":152,"path":153,"stem":154,"children":155,"page":113},"写作","i-lucide-square-pilcrow","\u002Fdocs\u002Fwriting","docs\u002F4.writing",[156,162,168,174,179,185],{"title":157,"path":158,"stem":159,"category":16,"description":160,"icon":161},"Markdown 语法","\u002Fdocs\u002Fwriting\u002Fmarkdown-syntax","docs\u002F4.writing\u002F1.markdown-syntax","文档页面使用标准 Markdown 编写：标题决定目录与锚点，配合强调、链接、列表、表格与引用组织内容。本页列出常用语法及其在 Movk Nuxt Docs 中的渲染效果。","i-lucide-heading",{"title":163,"path":164,"stem":165,"category":16,"description":166,"icon":167},"代码块","\u002Fdocs\u002Fwriting\u002Fcode-blocks","docs\u002F4.writing\u002F2.code-blocks","代码块默认使用 github-light \u002F github-dark 高亮，支持文件名、行高亮、复制按钮与颜色、图标预览；用 code-group、code-tree 等组件组织多文件与长代码示例。","i-lucide-square-code",{"title":169,"path":170,"stem":171,"category":16,"description":172,"icon":173},"MDC 组件","\u002Fdocs\u002Fwriting\u002Fmdc-components","docs\u002F4.writing\u002F3.mdc-components","在 Markdown 中用 MDC 语法嵌入 Nuxt UI 的 Prose 组件：提示块、徽标、卡片、折叠面板、选项卡、步骤、字段说明、图标与按键，无需编写 Vue 代码即可组织更有层次的文档内容。","i-lucide-puzzle",{"title":175,"path":176,"stem":177,"category":16,"description":178,"icon":106},"图片与视频","\u002Fdocs\u002Fwriting\u002Fmedia","docs\u002F4.writing\u002F4.media","用 Markdown 图片语法插入远程或本地图片，用 `u-color-mode-image` 为亮色与暗色模式分别提供截图，用 `:video` 嵌入视频；本页同时说明图片放置位置与替代文本的写法。",{"title":180,"path":181,"stem":182,"category":16,"description":183,"icon":184},"Mermaid 图表","\u002Fdocs\u002Fwriting\u002Fmermaid","docs\u002F4.writing\u002F5.mermaid","开启 `movkNuxtDocs.mermaid` 并安装 mermaid 与 dompurify 后，语言为 `mermaid` 的代码块渲染为流程图、时序图、类图等图表，随亮暗主题切换，进入视口时才加载，并提供复制与全屏查看。","i-lucide-workflow",{"title":186,"path":187,"stem":188,"category":16,"description":189,"icon":190},"内容组件","\u002Fdocs\u002Fwriting\u002Fcontent-components","docs\u002F4.writing\u002F6.content-components","layer 在 Nuxt UI Prose 组件之外提供的内容组件：为元素添加入场动画的 Motion、动态星空背景 StarsBg，以及编辑式落地页使用的 LandingCover、LandingSection 等组件，均可直接在 Markdown 中使用。","i-lucide-sparkle",{"title":192,"category":16,"description":16,"icon":193,"path":194,"stem":195,"children":196,"page":113},"组件","i-lucide-component","\u002Fdocs\u002Fcomponents","docs\u002F5.components",[197,203,209,215,221,227,233],{"title":198,"path":199,"stem":200,"category":16,"description":201,"icon":202},"ComponentProps","\u002Fdocs\u002Fcomponents\u002Fcomponent-props","docs\u002F5.components\u002F1.component-props","在 Markdown 中用一行 `:component-props` 生成 Vue 组件的 Props 表格，名称、默认值、类型与 JSDoc 说明均来自 nuxt-component-meta 提取的元数据，组件改动后文档自动同步。","i-lucide-list",{"title":204,"path":205,"stem":206,"category":16,"description":207,"icon":208},"ComponentSlots","\u002Fdocs\u002Fcomponents\u002Fcomponent-slots","docs\u002F5.components\u002F2.component-slots","用一行 `:component-slots` 列出 Vue 组件的全部插槽，插槽名、作用域参数类型与 JSDoc 说明来自 `defineSlots` 的类型定义，无需手写插槽文档。","i-lucide-layout-panel-left",{"title":210,"path":211,"stem":212,"category":16,"description":213,"icon":214},"ComponentEmits","\u002Fdocs\u002Fcomponents\u002Fcomponent-emits","docs\u002F5.components\u002F3.component-emits","用一行 `:component-emits` 列出 Vue 组件的全部事件，事件名、参数签名与 JSDoc 说明来自 `defineEmits` 的类型定义，与 Props、Slots 表格配套组成完整 API 文档。","i-lucide-radio-tower",{"title":216,"path":217,"stem":218,"category":16,"description":219,"icon":220},"ComponentExample","\u002Fdocs\u002Fcomponents\u002Fcomponent-example","docs\u002F5.components\u002F4.component-example","用 `:component-example` 把示例目录中的 Vue 文件渲染为实时预览，并在下方展示带高亮的源码；支持行高亮、折叠、可调参数与仅客户端渲染，适合展示组件在真实场景下的组合用法。","i-lucide-app-window",{"title":222,"path":223,"stem":224,"category":16,"description":225,"icon":226},"ComponentCode","\u002Fdocs\u002Fcomponents\u002Fcomponent-code","docs\u002F5.components\u002F5.component-code","用 `::component-code` 以属性矩阵驱动任意已注册的 Vue 组件实时渲染，读者在预览上方切换属性值，下方的 Vue 代码片段同步更新，可直接复制使用。","i-lucide-sliders-horizontal",{"title":228,"path":229,"stem":230,"category":16,"description":231,"icon":232},"CommitChangelog","\u002Fdocs\u002Fcomponents\u002Fcommit-changelog","docs\u002F5.components\u002F6.commit-changelog","用 `:commit-changelog` 从 GitHub 拉取组件或源文件的提交记录，按版本分组展示为时间线；文件路径由组件名推导，可按目录、扩展名、命名格式与作者调整，一篇文档也可关联多个文件。","i-lucide-git-commit-horizontal",{"title":234,"path":235,"stem":236,"category":16,"description":237,"icon":238},"PageLastCommit","\u002Fdocs\u002Fcomponents\u002Fpage-last-commit","docs\u002F5.components\u002F7.page-last-commit","文档页导语下方的元信息行会显示当前 Markdown 文件的最后一次提交，包括时间、作者与提交信息；本页说明它的启用条件、日期格式配置与 PR squash merge 的作者识别。","i-lucide-history",{"title":240,"category":16,"description":16,"icon":241,"path":242,"stem":243,"children":244,"page":113},"参考","i-lucide-book-marked","\u002Fdocs\u002Freference","docs\u002F6.reference",[245,251,257,332],{"title":246,"path":247,"stem":248,"category":16,"description":249,"icon":250},"app.config 参考","\u002Fdocs\u002Freference\u002Fapp-config","docs\u002F6.reference\u002F1.app-config","app.config.ts 全部配置项的字段、类型、默认值与说明，由 layer 的 nuxt.schema.ts 自动生成，与发布版本保持一致。需要了解某一项的用法时，从这里跳转到对应指南。","i-lucide-file-cog",{"title":252,"path":253,"stem":254,"category":16,"description":255,"icon":256},"nuxt.config 选项","\u002Fdocs\u002Freference\u002Fnuxt-config","docs\u002F6.reference\u002F2.nuxt-config","Layer 在构建期读取的全部 nuxt.config 选项与环境变量，包括功能开关、AI Chat、组件元数据、MCP、llms.txt、代理发现与站点信息。修改这些选项后需要重新构建或重启开发服务器。","i-lucide-settings-2",{"title":258,"category":16,"description":16,"icon":259,"path":260,"stem":261,"children":262,"page":113},"组合式函数","i-lucide-square-function","\u002Fdocs\u002Freference\u002Fcomposables","docs\u002F6.reference\u002F3.composables",[263,268,274,280,286,292,298,304,310,315,321,327],{"title":264,"path":265,"stem":266,"category":16,"description":267,"icon":100},"useMovkI18n","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-movk-i18n","docs\u002F6.reference\u002F3.composables\u002F1.use-movk-i18n","统一的多语言访问入口。无论是否启用 @nuxtjs\u002Fi18n，都能用同一套 API 读取当前语言、翻译文案、生成带语言前缀的链接，并拿到当前语言对应的内容集合名与文档根路径。",{"title":269,"path":270,"stem":271,"category":16,"description":272,"icon":273},"useLocaleSeo","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-locale-seo","docs\u002F6.reference\u002F3.composables\u002F10.use-locale-seo","为多语言站点注入 hreflang alternate 链接、x-default 与 og:locale，让搜索引擎正确识别各语言版本。layer 的 app.vue 已全局调用；只有在项目中重写 app.vue 时需要自行调用。","i-lucide-globe",{"title":275,"path":276,"stem":277,"category":16,"description":278,"icon":279},"useFetchComponentMeta","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-fetch-component-meta","docs\u002F6.reference\u002F3.composables\u002F11.use-fetch-component-meta","读取 nuxt-component-meta 生成的组件元数据，包括 Props、Slots、Events 的类型与说明。ComponentProps 等组件文档组件都基于它实现，需要自行渲染组件 API 表格时直接调用。仅在开启组件文档功能时可用。","i-lucide-braces",{"title":281,"path":282,"stem":283,"category":16,"description":284,"icon":285},"useFetchComponentExample","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-fetch-component-example","docs\u002F6.reference\u002F3.composables\u002F12.use-fetch-component-example","读取 components\u002Fcontent\u002Fexamples 下示例组件的源码、文件路径与组件名。ComponentExample 用它展示示例代码，需要在自定义组件中显示示例源码时直接调用。仅在开启组件文档功能时可用。","i-lucide-file-code",{"title":287,"path":288,"stem":289,"category":16,"description":290,"icon":291},"useDocsNavigation","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-navigation","docs\u002F6.reference\u002F3.composables\u002F2.use-docs-navigation","读取外壳预先加载好的文档导航树。页头栏目条、侧栏和文档页都从这里拿导航数据，自定义组件调用它即可复用同一份数据，不会再次查询内容集合。","i-lucide-list-tree",{"title":293,"path":294,"stem":295,"category":16,"description":296,"icon":297},"useNavigation","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-navigation","docs\u002F6.reference\u002F3.composables\u002F3.use-navigation","把文档导航树加工成侧栏需要的形态：取出顶层栏目、把当前栏目的页面按 docs.categories 分组，并为任意路径生成面包屑。自定义侧栏或目录组件时用它保持与默认实现一致的分组规则。","i-lucide-panel-left",{"title":299,"path":300,"stem":301,"category":16,"description":302,"icon":303},"useHeader","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-header","docs\u002F6.reference\u002F3.composables\u002F4.use-header","提供页头桌面端与移动端导航链接。推荐直接在 app.config 的 header.nav 与 header.mobileNav 中声明；需要按运行时状态动态生成链接时，再在项目中创建同名 composable 覆盖它。","i-lucide-panel-top",{"title":305,"path":306,"stem":307,"category":16,"description":308,"icon":309},"useCategory","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-category","docs\u002F6.reference\u002F3.composables\u002F5.use-category","提供侧栏分类定义，决定栏目内带 category 的页面如何分组、按什么顺序显示。推荐在 app.config 的 docs.categories 中声明；只有分类需要在运行时计算时，才在项目中创建同名 composable 覆盖。","i-lucide-folders",{"title":311,"path":312,"stem":313,"category":16,"description":314,"icon":69},"useTheme","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-theme","docs\u002F6.reference\u002F3.composables\u002F6.use-theme","主题面板背后的状态与操作：主色、中性色、圆角、图标集、黑色主色与颜色模式，访客的选择保存在 localStorage，并能导出为 app.config 或 CSS 片段。自定义主题面板或在页面中切换主题时使用。",{"title":316,"path":317,"stem":318,"category":16,"description":319,"icon":320},"useDocsRoute","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-route","docs\u002F6.reference\u002F3.composables\u002F7.use-docs-route","判断当前路由是否是文档子页面，兼容默认语言的 \u002Fdocs\u002F* 与其他语言的 \u002F{locale}\u002Fdocs\u002F*。自定义页头、页脚等全站组件需要只在文档页显示某些内容时使用。","i-lucide-route",{"title":322,"path":323,"stem":324,"category":16,"description":325,"icon":326},"useDocsFilterConfig","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-filter-config","docs\u002F6.reference\u002F3.composables\u002F8.use-docs-filter-config","侧栏导航过滤框的配置、显示条件与过滤函数，对应 app.config 的 aside.filter。自定义侧栏顶部或侧栏主体组件时，用这些函数保持与默认过滤行为一致。","i-lucide-list-filter",{"title":328,"path":329,"stem":330,"category":16,"description":331,"icon":220},"useDocsShell","\u002Fdocs\u002Freference\u002Fcomposables\u002Fuse-docs-shell","docs\u002F6.reference\u002F3.composables\u002F9.use-docs-shell","app.vue 与 error.vue 共用的站点外壳：按当前语言加载导航树与搜索索引，注入 html 语言、方向、字体与颗粒属性，并向组件树提供导航。只有在项目中完全重写 app.vue 或 error.vue 时才需要直接调用它。",{"title":333,"path":334,"stem":335,"category":16,"description":336,"icon":337},"A–Z 索引","\u002Fdocs\u002Freference\u002Fa-z","docs\u002F6.reference\u002F9.a-z","按英文标题首字母列出全部文档页面，记得功能名称却不确定它在哪个分区时，从这里直接跳转；中文页面同时显示英文标题以便按字母查找。","i-lucide-list-ordered",{"data":339,"body":340},{},{"type":341,"children":342},"root",[343],{"type":344,"tag":345,"props":346,"children":347},"element","p",{},[348],{"type":349,"value":350},"text","Copyright © 2024 - 2026",{"id":352,"title":127,"body":353,"category":16,"description":130,"difficulty":16,"extension":2183,"index":113,"keywords":16,"links":16,"meta":2184,"navigation":2185,"path":128,"requires":16,"seo":2186,"sitemap":2188,"stem":129,"__hash__":2189},"docs\u002Fdocs\u002F3.ai\u002F2.mcp.md",{"type":354,"value":355,"toc":2156},"minimark",[356,375,393,397,401,414,472,479,487,490,500,562,577,580,583,752,781,784,841,844,847,879,882,901,904,911,924,931,934,940,944,975,979,982,989,1080,1087,1091,1094,1097,1104,1157,1161,1168,1232,1236,1314,1318,1324,1330,1333,1340,1343,1687,1694,1697,1905,1908,2067,2070,2079,2148,2152],[345,357,358,365,366,374],{},[359,360,364],"a",{"href":361,"rel":362},"https:\u002F\u002Fmodelcontextprotocol.io",[363],"nofollow","Model Context Protocol","（MCP）是 AI 应用连接外部服务的开放协议。Movk Nuxt Docs 基于 ",[359,367,370],{"href":368,"rel":369},"https:\u002F\u002Fmcp-toolkit.nuxt.dev",[363],[371,372,373],"code",{},"@nuxtjs\u002Fmcp-toolkit"," 内置一个 MCP Server，接入后，Claude、Cursor 等助手会在需要时自行搜索和阅读你的文档，而不是凭训练数据作答。",[345,376,377,378,381,382,385,386,389,390,392],{},"服务器默认开启，地址为站点的 ",[371,379,380],{},"\u002Fmcp"," 路径。例如文档部署在 ",[371,383,384],{},"https:\u002F\u002Fdocs.example.com","，则 MCP 地址为 ",[371,387,388],{},"https:\u002F\u002Fdocs.example.com\u002Fmcp","。",[359,391,121],{"href":122}," 也通过这组工具读取文档。",[394,395,396],"h2",{"id":396},"配置",[398,399,400],"h3",{"id":400},"关闭",[345,402,403,404,407,408,410,411,413],{},"MCP 由功能开关 ",[371,405,406],{},"movkNuxtDocs.mcp"," 控制，关闭后 ",[371,409,373],{}," 不会被安装为模块，",[371,412,380],{}," 与 MCP 服务卡片一并移除：",[415,416,422],"pre",{"className":417,"code":418,"filename":419,"language":420,"meta":421,"style":421},"language-ts shiki shiki-themes github-light github-light github-dark","export default defineNuxtConfig({\n  movkNuxtDocs: {\n    mcp: false\n  }\n})\n","nuxt.config.ts","ts","",[371,423,424,444,450,460,466],{"__ignoreMap":421},[425,426,429,433,436,440],"span",{"class":427,"line":428},"line",1,[425,430,432],{"class":431},"s8jYJ","export",[425,434,435],{"class":431}," default",[425,437,439],{"class":438},"snPdu"," defineNuxtConfig",[425,441,443],{"class":442},"sxrX7","({\n",[425,445,447],{"class":427,"line":446},2,[425,448,449],{"class":442},"  movkNuxtDocs: {\n",[425,451,453,456],{"class":427,"line":452},3,[425,454,455],{"class":442},"    mcp: ",[425,457,459],{"class":458},"sBjJW","false\n",[425,461,463],{"class":427,"line":462},4,[425,464,465],{"class":442},"  }\n",[425,467,469],{"class":427,"line":468},5,[425,470,471],{"class":442},"})\n",[473,474,475,476,478],"warning",{},"启用 ",[359,477,121],{"href":122}," 时不能关闭 MCP，否则构建报错。",[480,481,482,483,486],"note",{},"MCP Server 需要运行中的服务端，",[371,484,485],{},"nuxt generate"," 纯静态部署时不可用。",[398,488,489],{"id":489},"名称与浏览器跳转",[345,491,492,493,496,497,499],{},"其他选项写在 ",[371,494,495],{},"mcp"," 下，由 ",[371,498,373],{}," 读取：",[415,501,503],{"className":417,"code":502,"filename":419,"language":420,"meta":421,"style":421},"export default defineNuxtConfig({\n  mcp: {\n    \u002F\u002F 客户端看到的服务器名称\n    name: 'My Docs',\n    \u002F\u002F 在浏览器中直接打开 \u002Fmcp 时跳转到的页面\n    browserRedirect: '\u002Fdocs\u002Fai\u002Fmcp'\n  }\n})\n",[371,504,505,515,520,526,538,543,552,557],{"__ignoreMap":421},[425,506,507,509,511,513],{"class":427,"line":428},[425,508,432],{"class":431},[425,510,435],{"class":431},[425,512,439],{"class":438},[425,514,443],{"class":442},[425,516,517],{"class":427,"line":446},[425,518,519],{"class":442},"  mcp: {\n",[425,521,522],{"class":427,"line":452},[425,523,525],{"class":524},"sCsY4","    \u002F\u002F 客户端看到的服务器名称\n",[425,527,528,531,535],{"class":427,"line":462},[425,529,530],{"class":442},"    name: ",[425,532,534],{"class":533},"sIIMD","'My Docs'",[425,536,537],{"class":442},",\n",[425,539,540],{"class":427,"line":468},[425,541,542],{"class":524},"    \u002F\u002F 在浏览器中直接打开 \u002Fmcp 时跳转到的页面\n",[425,544,546,549],{"class":427,"line":545},6,[425,547,548],{"class":442},"    browserRedirect: ",[425,550,551],{"class":533},"'\u002Fdocs\u002Fai\u002Fmcp'\n",[425,553,555],{"class":427,"line":554},7,[425,556,465],{"class":442},[425,558,560],{"class":427,"line":559},8,[425,561,471],{"class":442},[345,563,564,567,568,572,573,389],{},[371,565,566],{},"browserRedirect"," 同时作为 ",[359,569,571],{"href":570},"\u002Fdocs\u002Fai\u002Fagent-discovery#mcp-%E6%9C%8D%E5%8A%A1%E5%8D%A1%E7%89%87","MCP 服务卡片"," 中的文档地址。更多选项见 ",[359,574,576],{"href":368,"rel":575},[363],"MCP Toolkit 文档",[394,578,579],{"id":579},"内置能力",[398,581,582],{"id":582},"工具",[584,585,586,601],"table",{},[587,588,589],"thead",{},[590,591,592,595,598],"tr",{},[593,594,582],"th",{},[593,596,597],{},"用途",[593,599,600],{},"主要参数",[602,603,604,627,645,661,681,700,713,728],"tbody",{},[590,605,606,612,615],{},[607,608,609],"td",{},[371,610,611],{},"search-documentation",[607,613,614],{},"按标题、路径或描述搜索页面，不传参数时列出全部页面",[607,616,617,620,621,620,624],{},[371,618,619],{},"search","、",[371,622,623],{},"section",[371,625,626],{},"locale",[590,628,629,634,637],{},[607,630,631],{},[371,632,633],{},"get-documentation-page",[607,635,636],{},"按路径返回一页的 Markdown，可只取指定的 H2 章节",[607,638,639,620,642],{},[371,640,641],{},"path",[371,643,644],{},"headings",[590,646,647,652,655],{},[607,648,649],{},[371,650,651],{},"search-composables",[607,653,654],{},"按关键词查找组合式函数页面",[607,656,657,620,659],{},[371,658,619],{},[371,660,626],{},[590,662,663,668,671],{},[607,664,665],{},[371,666,667],{},"get-component",[607,669,670],{},"返回组件文档与元信息，可只取部分章节",[607,672,673,620,676,620,679],{},[371,674,675],{},"componentName",[371,677,678],{},"sections",[371,680,626],{},[590,682,683,688,691],{},[607,684,685],{},[371,686,687],{},"get-component-metadata",[607,689,690],{},"返回组件的 props、slots、emits",[607,692,693,620,695,620,698],{},[371,694,675],{},[371,696,697],{},"full",[371,699,626],{},[590,701,702,707,710],{},[607,703,704],{},[371,705,706],{},"list-examples",[607,708,709],{},"列出全部示例名称",[607,711,712],{},"无",[590,714,715,720,723],{},[607,716,717],{},[371,718,719],{},"get-example",[607,721,722],{},"返回示例源码",[607,724,725],{},[371,726,727],{},"exampleName",[590,729,730,735,741],{},[607,731,732],{},[371,733,734],{},"search-icons",[607,736,737,738],{},"在一个 Iconify 图标集中搜索图标，默认 ",[371,739,740],{},"lucide",[607,742,743,620,746,620,749],{},[371,744,745],{},"query",[371,747,748],{},"collection",[371,750,751],{},"limit",[345,753,754,755,758,759,761,762,765,766,769,770,773,774,776,777,780],{},"组件与示例相关的工具依赖",[359,756,757],{"href":199},"组件文档","功能，未启用时没有可返回的数据。",[371,760,651],{}," 查找路径中含 ",[371,763,764],{},"composables\u002F"," 的页面（如 ",[371,767,768],{},"\u002Fdocs\u002Fcomposables\u002F"," 或 ",[371,771,772],{},"\u002Fdocs\u002Freference\u002Fcomposables\u002F","），",[371,775,667],{}," 等查找路径中含 ",[371,778,779],{},"\u002Fcomponents\u002F"," 的页面。",[398,782,783],{"id":783},"资源",[584,785,786,796],{},[587,787,788],{},[590,789,790,793],{},[593,791,792],{},"URI",[593,794,795],{},"内容",[602,797,798,808,821,831],{},[590,799,800,805],{},[607,801,802],{},[371,803,804],{},"resource:\u002F\u002Fdocs\u002Fdocumentation-pages",[607,806,807],{},"全部文档页面的标题、描述与路径",[590,809,810,815],{},[607,811,812],{},[371,813,814],{},"resource:\u002F\u002Fdocs\u002Fcomponents",[607,816,817,818],{},"组件页面及其分类与 ",[371,819,820],{},"keywords",[590,822,823,828],{},[607,824,825],{},[371,826,827],{},"resource:\u002F\u002Fdocs\u002Fcomposables",[607,829,830],{},"组合式函数页面",[590,832,833,838],{},[607,834,835],{},[371,836,837],{},"resource:\u002F\u002Fdocs\u002Fexamples",[607,839,840],{},"示例名称列表",[345,842,843],{},"资源只列出默认语言的内容。",[398,845,846],{"id":846},"提示词",[584,848,849,857],{},[587,850,851],{},[590,852,853,855],{},[593,854,846],{},[593,856,597],{},[602,858,859,869],{},[590,860,861,866],{},[607,862,863],{},[371,864,865],{},"find-component-for-usecase",[607,867,868],{},"根据使用场景推荐合适的组件",[590,870,871,876],{},[607,872,873],{},[371,874,875],{},"implement-component-with-props",[607,877,878],{},"基于组件文档与元数据生成实现代码",[398,880,881],{"id":881},"多语言",[345,883,884,885,887,888,890,891,894,895,897,898,389],{},"启用",[359,886,96],{"href":97},"后，带 ",[371,889,626],{}," 参数的工具与两个提示词按该语言查询对应的内容集合与 ",[371,892,893],{},"\u002F{locale}\u002Fdocs"," 前缀，省略时为默认语言；传入未注册的语言返回 400 并列出可用语言。",[371,896,633],{}," 直接按路径定位，如 ",[371,899,900],{},"\u002Fen\u002Fdocs\u002Fgetting-started",[398,902,903],{"id":903},"限制工具",[345,905,906,907,910],{},"客户端可以通过 ",[371,908,909],{},"X-MCP-Tools"," 请求头（逗号分隔的工具名）只暴露需要的工具，减少上下文占用：",[912,913,914,918,921],"ul",{},[915,916,917],"li",{},"不传该请求头：暴露全部工具",[915,919,920],{},"传空值：不暴露任何工具",[915,922,923],{},"包含未知工具名：返回 400",[345,925,926,927,930],{},"这一过滤由 layer 的 ",[371,928,929],{},"server\u002Fmcp\u002Findex.ts"," 实现，客户端配置示例见下文 Cursor 一节。",[394,932,933],{"id":933},"接入客户端",[345,935,936,937,939],{},"MCP Server 使用 HTTP 传输，以下示例中的 ",[371,938,388],{}," 替换为你的地址。",[398,941,943],{"id":942},"claude-code","Claude Code",[415,945,950],{"className":946,"code":947,"filename":948,"language":949,"meta":421,"style":421},"language-bash shiki shiki-themes github-light github-light github-dark","claude mcp add --transport http my-docs https:\u002F\u002Fdocs.example.com\u002Fmcp\n","Terminal","bash",[371,951,952],{"__ignoreMap":421},[425,953,954,957,960,963,966,969,972],{"class":427,"line":428},[425,955,956],{"class":438},"claude",[425,958,959],{"class":533}," mcp",[425,961,962],{"class":533}," add",[425,964,965],{"class":458}," --transport",[425,967,968],{"class":533}," http",[425,970,971],{"class":533}," my-docs",[425,973,974],{"class":533}," https:\u002F\u002Fdocs.example.com\u002Fmcp\n",[398,976,978],{"id":977},"cursor","Cursor",[980,981],"install-button",{"url":388},[345,983,984,985,988],{},"或在项目根目录创建 ",[371,986,987],{},".cursor\u002Fmcp.json","：",[415,990,994],{"className":991,"code":992,"filename":987,"language":993,"meta":421,"style":421},"language-json shiki shiki-themes github-light github-light github-dark","{\n  \"mcpServers\": {\n    \"my-docs\": {\n      \"type\": \"http\",\n      \"url\": \"https:\u002F\u002Fdocs.example.com\u002Fmcp\",\n      \"headers\": {\n        \"X-MCP-Tools\": \"search-documentation,get-documentation-page\"\n      }\n    }\n  }\n}\n","json",[371,995,996,1001,1009,1016,1029,1041,1048,1058,1063,1069,1074],{"__ignoreMap":421},[425,997,998],{"class":427,"line":428},[425,999,1000],{"class":442},"{\n",[425,1002,1003,1006],{"class":427,"line":446},[425,1004,1005],{"class":458},"  \"mcpServers\"",[425,1007,1008],{"class":442},": {\n",[425,1010,1011,1014],{"class":427,"line":452},[425,1012,1013],{"class":458},"    \"my-docs\"",[425,1015,1008],{"class":442},[425,1017,1018,1021,1024,1027],{"class":427,"line":462},[425,1019,1020],{"class":458},"      \"type\"",[425,1022,1023],{"class":442},": ",[425,1025,1026],{"class":533},"\"http\"",[425,1028,537],{"class":442},[425,1030,1031,1034,1036,1039],{"class":427,"line":468},[425,1032,1033],{"class":458},"      \"url\"",[425,1035,1023],{"class":442},[425,1037,1038],{"class":533},"\"https:\u002F\u002Fdocs.example.com\u002Fmcp\"",[425,1040,537],{"class":442},[425,1042,1043,1046],{"class":427,"line":545},[425,1044,1045],{"class":458},"      \"headers\"",[425,1047,1008],{"class":442},[425,1049,1050,1053,1055],{"class":427,"line":554},[425,1051,1052],{"class":458},"        \"X-MCP-Tools\"",[425,1054,1023],{"class":442},[425,1056,1057],{"class":533},"\"search-documentation,get-documentation-page\"\n",[425,1059,1060],{"class":427,"line":559},[425,1061,1062],{"class":442},"      }\n",[425,1064,1066],{"class":427,"line":1065},9,[425,1067,1068],{"class":442},"    }\n",[425,1070,1072],{"class":427,"line":1071},10,[425,1073,465],{"class":442},[425,1075,1077],{"class":427,"line":1076},11,[425,1078,1079],{"class":442},"}\n",[345,1081,1082,1083,1086],{},"去掉 ",[371,1084,1085],{},"headers"," 即暴露全部工具。",[398,1088,1090],{"id":1089},"visual-studio-code","Visual Studio Code",[345,1092,1093],{},"需要安装 GitHub Copilot 与 GitHub Copilot Chat 扩展。",[980,1095],{"url":388,"ide":1096},"vscode",[345,1098,1099,1100,1103],{},"或在 ",[371,1101,1102],{},".vscode\u002Fmcp.json"," 中添加：",[415,1105,1107],{"className":991,"code":1106,"filename":1102,"language":993,"meta":421,"style":421},"{\n  \"servers\": {\n    \"my-docs\": {\n      \"type\": \"http\",\n      \"url\": \"https:\u002F\u002Fdocs.example.com\u002Fmcp\"\n    }\n  }\n}\n",[371,1108,1109,1113,1120,1126,1136,1145,1149,1153],{"__ignoreMap":421},[425,1110,1111],{"class":427,"line":428},[425,1112,1000],{"class":442},[425,1114,1115,1118],{"class":427,"line":446},[425,1116,1117],{"class":458},"  \"servers\"",[425,1119,1008],{"class":442},[425,1121,1122,1124],{"class":427,"line":452},[425,1123,1013],{"class":458},[425,1125,1008],{"class":442},[425,1127,1128,1130,1132,1134],{"class":427,"line":462},[425,1129,1020],{"class":458},[425,1131,1023],{"class":442},[425,1133,1026],{"class":533},[425,1135,537],{"class":442},[425,1137,1138,1140,1142],{"class":427,"line":468},[425,1139,1033],{"class":458},[425,1141,1023],{"class":442},[425,1143,1144],{"class":533},"\"https:\u002F\u002Fdocs.example.com\u002Fmcp\"\n",[425,1146,1147],{"class":427,"line":545},[425,1148,1068],{"class":442},[425,1150,1151],{"class":427,"line":554},[425,1152,465],{"class":442},[425,1154,1155],{"class":427,"line":559},[425,1156,1079],{"class":442},[398,1158,1160],{"id":1159},"claude-desktop","Claude Desktop",[345,1162,1163,1164,1167],{},"在「Settings → Developer → Edit Config」打开的 ",[371,1165,1166],{},"claude_desktop_config.json"," 中添加，然后重启应用：",[415,1169,1171],{"className":991,"code":1170,"filename":1166,"language":993,"meta":421,"style":421},"{\n  \"mcpServers\": {\n    \"my-docs\": {\n      \"command\": \"npx\",\n      \"args\": [\"mcp-remote\", \"https:\u002F\u002Fdocs.example.com\u002Fmcp\"]\n    }\n  }\n}\n",[371,1172,1173,1177,1183,1189,1201,1220,1224,1228],{"__ignoreMap":421},[425,1174,1175],{"class":427,"line":428},[425,1176,1000],{"class":442},[425,1178,1179,1181],{"class":427,"line":446},[425,1180,1005],{"class":458},[425,1182,1008],{"class":442},[425,1184,1185,1187],{"class":427,"line":452},[425,1186,1013],{"class":458},[425,1188,1008],{"class":442},[425,1190,1191,1194,1196,1199],{"class":427,"line":462},[425,1192,1193],{"class":458},"      \"command\"",[425,1195,1023],{"class":442},[425,1197,1198],{"class":533},"\"npx\"",[425,1200,537],{"class":442},[425,1202,1203,1206,1209,1212,1215,1217],{"class":427,"line":468},[425,1204,1205],{"class":458},"      \"args\"",[425,1207,1208],{"class":442},": [",[425,1210,1211],{"class":533},"\"mcp-remote\"",[425,1213,1214],{"class":442},", ",[425,1216,1038],{"class":533},[425,1218,1219],{"class":442},"]\n",[425,1221,1222],{"class":427,"line":545},[425,1223,1068],{"class":442},[425,1225,1226],{"class":427,"line":554},[425,1227,465],{"class":442},[425,1229,1230],{"class":427,"line":559},[425,1231,1079],{"class":442},[398,1233,1235],{"id":1234},"opencode","Opencode",[415,1237,1240],{"className":991,"code":1238,"filename":1239,"language":993,"meta":421,"style":421},"{\n  \"$schema\": \"https:\u002F\u002Fopencode.ai\u002Fconfig.json\",\n  \"mcp\": {\n    \"my-docs\": {\n      \"type\": \"remote\",\n      \"url\": \"https:\u002F\u002Fdocs.example.com\u002Fmcp\",\n      \"enabled\": true\n    }\n  }\n}\n","opencode.json",[371,1241,1242,1246,1258,1265,1271,1282,1292,1302,1306,1310],{"__ignoreMap":421},[425,1243,1244],{"class":427,"line":428},[425,1245,1000],{"class":442},[425,1247,1248,1251,1253,1256],{"class":427,"line":446},[425,1249,1250],{"class":458},"  \"$schema\"",[425,1252,1023],{"class":442},[425,1254,1255],{"class":533},"\"https:\u002F\u002Fopencode.ai\u002Fconfig.json\"",[425,1257,537],{"class":442},[425,1259,1260,1263],{"class":427,"line":452},[425,1261,1262],{"class":458},"  \"mcp\"",[425,1264,1008],{"class":442},[425,1266,1267,1269],{"class":427,"line":462},[425,1268,1013],{"class":458},[425,1270,1008],{"class":442},[425,1272,1273,1275,1277,1280],{"class":427,"line":468},[425,1274,1020],{"class":458},[425,1276,1023],{"class":442},[425,1278,1279],{"class":533},"\"remote\"",[425,1281,537],{"class":442},[425,1283,1284,1286,1288,1290],{"class":427,"line":545},[425,1285,1033],{"class":458},[425,1287,1023],{"class":442},[425,1289,1038],{"class":533},[425,1291,537],{"class":442},[425,1293,1294,1297,1299],{"class":427,"line":554},[425,1295,1296],{"class":458},"      \"enabled\"",[425,1298,1023],{"class":442},[425,1300,1301],{"class":458},"true\n",[425,1303,1304],{"class":427,"line":559},[425,1305,1068],{"class":442},[425,1307,1308],{"class":427,"line":1065},[425,1309,465],{"class":442},[425,1311,1312],{"class":427,"line":1071},[425,1313,1079],{"class":442},[398,1315,1317],{"id":1316},"chatgpt","ChatGPT",[345,1319,1320,1321,389],{},"在 ChatGPT 网页版「设置 → Connectors → Advanced settings」开启开发者模式，然后新建连接器，MCP server URL 填写你的地址，认证选择 ",[371,1322,1323],{},"None",[345,1325,1326,1327,1329],{},"接入后可以直接提问，例如「列出所有文档页面」「读取安装指南」「",[371,1328,198],{}," 接受哪些 props？」，助手会自行选择工具。",[394,1331,1332],{"id":1332},"扩展",[345,1334,1335,1336,1339],{},"服务器会自动加载项目 ",[371,1337,1338],{},"server\u002Fmcp\u002F"," 下的文件，与 layer 内置的定义合并。",[398,1341,1342],{"id":1342},"自定义工具",[415,1344,1347],{"className":417,"code":1345,"filename":1346,"language":420,"meta":421,"style":421},"import { z } from 'zod'\nimport { queryCollection } from '@nuxt\u002Fcontent\u002Fserver'\n\nexport default defineMcpTool({\n  description: '按关键词搜索文档标题与描述',\n  annotations: {\n    readOnlyHint: true,\n    destructiveHint: false,\n    idempotentHint: true,\n    openWorldHint: false\n  },\n  inputSchema: {\n    search: z.string().describe('搜索关键词')\n  },\n  cache: '30m',\n  async handler({ search }) {\n    const event = useEvent()\n    const keyword = search.toLowerCase()\n\n    const pages = await queryCollection(event, 'docs')\n      .select('title', 'description', 'path')\n      .all()\n\n    return pages.filter(page =>\n      page.title?.toLowerCase().includes(keyword)\n      || page.description?.toLowerCase().includes(keyword)\n    )\n  }\n})\n","server\u002Fmcp\u002Ftools\u002Fsearch-pages.ts",[371,1348,1349,1363,1375,1381,1392,1402,1407,1417,1427,1436,1443,1448,1454,1478,1483,1494,1512,1530,1548,1553,1577,1603,1613,1618,1638,1654,1671,1677,1682],{"__ignoreMap":421},[425,1350,1351,1354,1357,1360],{"class":427,"line":428},[425,1352,1353],{"class":431},"import",[425,1355,1356],{"class":442}," { z } ",[425,1358,1359],{"class":431},"from",[425,1361,1362],{"class":533}," 'zod'\n",[425,1364,1365,1367,1370,1372],{"class":427,"line":446},[425,1366,1353],{"class":431},[425,1368,1369],{"class":442}," { queryCollection } ",[425,1371,1359],{"class":431},[425,1373,1374],{"class":533}," '@nuxt\u002Fcontent\u002Fserver'\n",[425,1376,1377],{"class":427,"line":452},[425,1378,1380],{"emptyLinePlaceholder":1379},true,"\n",[425,1382,1383,1385,1387,1390],{"class":427,"line":462},[425,1384,432],{"class":431},[425,1386,435],{"class":431},[425,1388,1389],{"class":438}," defineMcpTool",[425,1391,443],{"class":442},[425,1393,1394,1397,1400],{"class":427,"line":468},[425,1395,1396],{"class":442},"  description: ",[425,1398,1399],{"class":533},"'按关键词搜索文档标题与描述'",[425,1401,537],{"class":442},[425,1403,1404],{"class":427,"line":545},[425,1405,1406],{"class":442},"  annotations: {\n",[425,1408,1409,1412,1415],{"class":427,"line":554},[425,1410,1411],{"class":442},"    readOnlyHint: ",[425,1413,1414],{"class":458},"true",[425,1416,537],{"class":442},[425,1418,1419,1422,1425],{"class":427,"line":559},[425,1420,1421],{"class":442},"    destructiveHint: ",[425,1423,1424],{"class":458},"false",[425,1426,537],{"class":442},[425,1428,1429,1432,1434],{"class":427,"line":1065},[425,1430,1431],{"class":442},"    idempotentHint: ",[425,1433,1414],{"class":458},[425,1435,537],{"class":442},[425,1437,1438,1441],{"class":427,"line":1071},[425,1439,1440],{"class":442},"    openWorldHint: ",[425,1442,459],{"class":458},[425,1444,1445],{"class":427,"line":1076},[425,1446,1447],{"class":442},"  },\n",[425,1449,1451],{"class":427,"line":1450},12,[425,1452,1453],{"class":442},"  inputSchema: {\n",[425,1455,1457,1460,1463,1466,1469,1472,1475],{"class":427,"line":1456},13,[425,1458,1459],{"class":442},"    search: z.",[425,1461,1462],{"class":438},"string",[425,1464,1465],{"class":442},"().",[425,1467,1468],{"class":438},"describe",[425,1470,1471],{"class":442},"(",[425,1473,1474],{"class":533},"'搜索关键词'",[425,1476,1477],{"class":442},")\n",[425,1479,1481],{"class":427,"line":1480},14,[425,1482,1447],{"class":442},[425,1484,1486,1489,1492],{"class":427,"line":1485},15,[425,1487,1488],{"class":442},"  cache: ",[425,1490,1491],{"class":533},"'30m'",[425,1493,537],{"class":442},[425,1495,1497,1500,1503,1506,1509],{"class":427,"line":1496},16,[425,1498,1499],{"class":431},"  async",[425,1501,1502],{"class":438}," handler",[425,1504,1505],{"class":442},"({ ",[425,1507,619],{"class":1508},"sP4rz",[425,1510,1511],{"class":442}," }) {\n",[425,1513,1515,1518,1521,1524,1527],{"class":427,"line":1514},17,[425,1516,1517],{"class":431},"    const",[425,1519,1520],{"class":458}," event",[425,1522,1523],{"class":431}," =",[425,1525,1526],{"class":438}," useEvent",[425,1528,1529],{"class":442},"()\n",[425,1531,1533,1535,1538,1540,1543,1546],{"class":427,"line":1532},18,[425,1534,1517],{"class":431},[425,1536,1537],{"class":458}," keyword",[425,1539,1523],{"class":431},[425,1541,1542],{"class":442}," search.",[425,1544,1545],{"class":438},"toLowerCase",[425,1547,1529],{"class":442},[425,1549,1551],{"class":427,"line":1550},19,[425,1552,1380],{"emptyLinePlaceholder":1379},[425,1554,1556,1558,1561,1563,1566,1569,1572,1575],{"class":427,"line":1555},20,[425,1557,1517],{"class":431},[425,1559,1560],{"class":458}," pages",[425,1562,1523],{"class":431},[425,1564,1565],{"class":431}," await",[425,1567,1568],{"class":438}," queryCollection",[425,1570,1571],{"class":442},"(event, ",[425,1573,1574],{"class":533},"'docs'",[425,1576,1477],{"class":442},[425,1578,1580,1583,1586,1588,1591,1593,1596,1598,1601],{"class":427,"line":1579},21,[425,1581,1582],{"class":442},"      .",[425,1584,1585],{"class":438},"select",[425,1587,1471],{"class":442},[425,1589,1590],{"class":533},"'title'",[425,1592,1214],{"class":442},[425,1594,1595],{"class":533},"'description'",[425,1597,1214],{"class":442},[425,1599,1600],{"class":533},"'path'",[425,1602,1477],{"class":442},[425,1604,1606,1608,1611],{"class":427,"line":1605},22,[425,1607,1582],{"class":442},[425,1609,1610],{"class":438},"all",[425,1612,1529],{"class":442},[425,1614,1616],{"class":427,"line":1615},23,[425,1617,1380],{"emptyLinePlaceholder":1379},[425,1619,1621,1624,1627,1630,1632,1635],{"class":427,"line":1620},24,[425,1622,1623],{"class":431},"    return",[425,1625,1626],{"class":442}," pages.",[425,1628,1629],{"class":438},"filter",[425,1631,1471],{"class":442},[425,1633,1634],{"class":1508},"page",[425,1636,1637],{"class":431}," =>\n",[425,1639,1641,1644,1646,1648,1651],{"class":427,"line":1640},25,[425,1642,1643],{"class":442},"      page.title?.",[425,1645,1545],{"class":438},[425,1647,1465],{"class":442},[425,1649,1650],{"class":438},"includes",[425,1652,1653],{"class":442},"(keyword)\n",[425,1655,1657,1660,1663,1665,1667,1669],{"class":427,"line":1656},26,[425,1658,1659],{"class":431},"      ||",[425,1661,1662],{"class":442}," page.description?.",[425,1664,1545],{"class":438},[425,1666,1465],{"class":442},[425,1668,1650],{"class":438},[425,1670,1653],{"class":442},[425,1672,1674],{"class":427,"line":1673},27,[425,1675,1676],{"class":442},"    )\n",[425,1678,1680],{"class":427,"line":1679},28,[425,1681,465],{"class":442},[425,1683,1685],{"class":427,"line":1684},29,[425,1686,471],{"class":442},[345,1688,1689,1690,1693],{},"工具名默认取文件名（kebab-case）。在项目中创建与内置工具同名的文件（如 ",[371,1691,1692],{},"server\u002Fmcp\u002Ftools\u002Fsearch-documentation.ts","）即可覆盖内置实现。",[398,1695,1696],{"id":1696},"自定义资源",[415,1698,1701],{"className":417,"code":1699,"filename":1700,"language":420,"meta":421,"style":421},"import { queryCollection } from '@nuxt\u002Fcontent\u002Fserver'\n\nexport default defineMcpResource({\n  uri: 'resource:\u002F\u002Fdocs\u002Fpage-index',\n  description: '全部页面的标题与路径',\n  cache: '1h',\n  async handler(uri: URL) {\n    const pages = await queryCollection(useEvent(), 'docs')\n      .select('title', 'path')\n      .all()\n\n    return {\n      contents: [{\n        uri: uri.toString(),\n        mimeType: 'application\u002Fjson',\n        text: JSON.stringify(pages, null, 2)\n      }]\n    }\n  }\n})\n","server\u002Fmcp\u002Fresources\u002Fpage-index.ts",[371,1702,1703,1713,1717,1728,1738,1747,1756,1776,1800,1816,1824,1828,1835,1840,1851,1861,1888,1893,1897,1901],{"__ignoreMap":421},[425,1704,1705,1707,1709,1711],{"class":427,"line":428},[425,1706,1353],{"class":431},[425,1708,1369],{"class":442},[425,1710,1359],{"class":431},[425,1712,1374],{"class":533},[425,1714,1715],{"class":427,"line":446},[425,1716,1380],{"emptyLinePlaceholder":1379},[425,1718,1719,1721,1723,1726],{"class":427,"line":452},[425,1720,432],{"class":431},[425,1722,435],{"class":431},[425,1724,1725],{"class":438}," defineMcpResource",[425,1727,443],{"class":442},[425,1729,1730,1733,1736],{"class":427,"line":462},[425,1731,1732],{"class":442},"  uri: ",[425,1734,1735],{"class":533},"'resource:\u002F\u002Fdocs\u002Fpage-index'",[425,1737,537],{"class":442},[425,1739,1740,1742,1745],{"class":427,"line":468},[425,1741,1396],{"class":442},[425,1743,1744],{"class":533},"'全部页面的标题与路径'",[425,1746,537],{"class":442},[425,1748,1749,1751,1754],{"class":427,"line":545},[425,1750,1488],{"class":442},[425,1752,1753],{"class":533},"'1h'",[425,1755,537],{"class":442},[425,1757,1758,1760,1762,1764,1767,1770,1773],{"class":427,"line":554},[425,1759,1499],{"class":431},[425,1761,1502],{"class":438},[425,1763,1471],{"class":442},[425,1765,1766],{"class":1508},"uri",[425,1768,1769],{"class":431},":",[425,1771,1772],{"class":438}," URL",[425,1774,1775],{"class":442},") {\n",[425,1777,1778,1780,1782,1784,1786,1788,1790,1793,1796,1798],{"class":427,"line":559},[425,1779,1517],{"class":431},[425,1781,1560],{"class":458},[425,1783,1523],{"class":431},[425,1785,1565],{"class":431},[425,1787,1568],{"class":438},[425,1789,1471],{"class":442},[425,1791,1792],{"class":438},"useEvent",[425,1794,1795],{"class":442},"(), ",[425,1797,1574],{"class":533},[425,1799,1477],{"class":442},[425,1801,1802,1804,1806,1808,1810,1812,1814],{"class":427,"line":1065},[425,1803,1582],{"class":442},[425,1805,1585],{"class":438},[425,1807,1471],{"class":442},[425,1809,1590],{"class":533},[425,1811,1214],{"class":442},[425,1813,1600],{"class":533},[425,1815,1477],{"class":442},[425,1817,1818,1820,1822],{"class":427,"line":1071},[425,1819,1582],{"class":442},[425,1821,1610],{"class":438},[425,1823,1529],{"class":442},[425,1825,1826],{"class":427,"line":1076},[425,1827,1380],{"emptyLinePlaceholder":1379},[425,1829,1830,1832],{"class":427,"line":1450},[425,1831,1623],{"class":431},[425,1833,1834],{"class":442}," {\n",[425,1836,1837],{"class":427,"line":1456},[425,1838,1839],{"class":442},"      contents: [{\n",[425,1841,1842,1845,1848],{"class":427,"line":1480},[425,1843,1844],{"class":442},"        uri: uri.",[425,1846,1847],{"class":438},"toString",[425,1849,1850],{"class":442},"(),\n",[425,1852,1853,1856,1859],{"class":427,"line":1485},[425,1854,1855],{"class":442},"        mimeType: ",[425,1857,1858],{"class":533},"'application\u002Fjson'",[425,1860,537],{"class":442},[425,1862,1863,1866,1869,1872,1875,1878,1881,1883,1886],{"class":427,"line":1496},[425,1864,1865],{"class":442},"        text: ",[425,1867,1868],{"class":458},"JSON",[425,1870,1871],{"class":442},".",[425,1873,1874],{"class":438},"stringify",[425,1876,1877],{"class":442},"(pages, ",[425,1879,1880],{"class":458},"null",[425,1882,1214],{"class":442},[425,1884,1885],{"class":458},"2",[425,1887,1477],{"class":442},[425,1889,1890],{"class":427,"line":1514},[425,1891,1892],{"class":442},"      }]\n",[425,1894,1895],{"class":427,"line":1532},[425,1896,1068],{"class":442},[425,1898,1899],{"class":427,"line":1550},[425,1900,465],{"class":442},[425,1902,1903],{"class":427,"line":1555},[425,1904,471],{"class":442},[398,1906,1907],{"id":1907},"自定义提示词",[415,1909,1912],{"className":417,"code":1910,"filename":1911,"language":420,"meta":421,"style":421},"import { z } from 'zod'\n\nexport default defineMcpPrompt({\n  description: '解释一个配置项的作用与默认值',\n  inputSchema: {\n    key: z.string().describe('配置项路径，如 header.nav')\n  },\n  async handler({ key }) {\n    return {\n      messages: [{\n        role: 'user' as const,\n        content: {\n          type: 'text' as const,\n          text: `阅读 app.config 参考页，解释配置项 ${key} 的作用、类型与默认值。`\n        }\n      }]\n    }\n  }\n})\n","server\u002Fmcp\u002Fprompts\u002Fexplain-config.ts",[371,1913,1914,1924,1928,1939,1948,1952,1970,1974,1987,1993,1998,2014,2019,2033,2046,2051,2055,2059,2063],{"__ignoreMap":421},[425,1915,1916,1918,1920,1922],{"class":427,"line":428},[425,1917,1353],{"class":431},[425,1919,1356],{"class":442},[425,1921,1359],{"class":431},[425,1923,1362],{"class":533},[425,1925,1926],{"class":427,"line":446},[425,1927,1380],{"emptyLinePlaceholder":1379},[425,1929,1930,1932,1934,1937],{"class":427,"line":452},[425,1931,432],{"class":431},[425,1933,435],{"class":431},[425,1935,1936],{"class":438}," defineMcpPrompt",[425,1938,443],{"class":442},[425,1940,1941,1943,1946],{"class":427,"line":462},[425,1942,1396],{"class":442},[425,1944,1945],{"class":533},"'解释一个配置项的作用与默认值'",[425,1947,537],{"class":442},[425,1949,1950],{"class":427,"line":468},[425,1951,1453],{"class":442},[425,1953,1954,1957,1959,1961,1963,1965,1968],{"class":427,"line":545},[425,1955,1956],{"class":442},"    key: z.",[425,1958,1462],{"class":438},[425,1960,1465],{"class":442},[425,1962,1468],{"class":438},[425,1964,1471],{"class":442},[425,1966,1967],{"class":533},"'配置项路径，如 header.nav'",[425,1969,1477],{"class":442},[425,1971,1972],{"class":427,"line":554},[425,1973,1447],{"class":442},[425,1975,1976,1978,1980,1982,1985],{"class":427,"line":559},[425,1977,1499],{"class":431},[425,1979,1502],{"class":438},[425,1981,1505],{"class":442},[425,1983,1984],{"class":1508},"key",[425,1986,1511],{"class":442},[425,1988,1989,1991],{"class":427,"line":1065},[425,1990,1623],{"class":431},[425,1992,1834],{"class":442},[425,1994,1995],{"class":427,"line":1071},[425,1996,1997],{"class":442},"      messages: [{\n",[425,1999,2000,2003,2006,2009,2012],{"class":427,"line":1076},[425,2001,2002],{"class":442},"        role: ",[425,2004,2005],{"class":533},"'user'",[425,2007,2008],{"class":431}," as",[425,2010,2011],{"class":431}," const",[425,2013,537],{"class":442},[425,2015,2016],{"class":427,"line":1450},[425,2017,2018],{"class":442},"        content: {\n",[425,2020,2021,2024,2027,2029,2031],{"class":427,"line":1456},[425,2022,2023],{"class":442},"          type: ",[425,2025,2026],{"class":533},"'text'",[425,2028,2008],{"class":431},[425,2030,2011],{"class":431},[425,2032,537],{"class":442},[425,2034,2035,2038,2041,2043],{"class":427,"line":1480},[425,2036,2037],{"class":442},"          text: ",[425,2039,2040],{"class":533},"`阅读 app.config 参考页，解释配置项 ${",[425,2042,1984],{"class":442},[425,2044,2045],{"class":533},"} 的作用、类型与默认值。`\n",[425,2047,2048],{"class":427,"line":1485},[425,2049,2050],{"class":442},"        }\n",[425,2052,2053],{"class":427,"line":1496},[425,2054,1892],{"class":442},[425,2056,2057],{"class":427,"line":1514},[425,2058,1068],{"class":442},[425,2060,2061],{"class":427,"line":1532},[425,2062,465],{"class":442},[425,2064,2065],{"class":427,"line":1550},[425,2066,471],{"class":442},[398,2068,2069],{"id":2069},"覆盖默认处理器",[345,2071,2072,2073,2075,2076,2078],{},"layer 的 ",[371,2074,929],{}," 是默认处理器，负责 ",[371,2077,909],{}," 过滤。在项目中创建同路径文件即可替换：",[415,2080,2082],{"className":417,"code":2081,"filename":929,"language":420,"meta":421,"style":421},"import { defineMcpHandler, getMcpTools } from '@nuxtjs\u002Fmcp-toolkit\u002Fserver'\n\nexport default defineMcpHandler({\n  async tools(event) {\n    return getMcpTools({ event, orphansOnly: true })\n  }\n})\n",[371,2083,2084,2096,2100,2111,2125,2140,2144],{"__ignoreMap":421},[425,2085,2086,2088,2091,2093],{"class":427,"line":428},[425,2087,1353],{"class":431},[425,2089,2090],{"class":442}," { defineMcpHandler, getMcpTools } ",[425,2092,1359],{"class":431},[425,2094,2095],{"class":533}," '@nuxtjs\u002Fmcp-toolkit\u002Fserver'\n",[425,2097,2098],{"class":427,"line":446},[425,2099,1380],{"emptyLinePlaceholder":1379},[425,2101,2102,2104,2106,2109],{"class":427,"line":452},[425,2103,432],{"class":431},[425,2105,435],{"class":431},[425,2107,2108],{"class":438}," defineMcpHandler",[425,2110,443],{"class":442},[425,2112,2113,2115,2118,2120,2123],{"class":427,"line":462},[425,2114,1499],{"class":431},[425,2116,2117],{"class":438}," tools",[425,2119,1471],{"class":442},[425,2121,2122],{"class":1508},"event",[425,2124,1775],{"class":442},[425,2126,2127,2129,2132,2135,2137],{"class":427,"line":468},[425,2128,1623],{"class":431},[425,2130,2131],{"class":438}," getMcpTools",[425,2133,2134],{"class":442},"({ event, orphansOnly: ",[425,2136,1414],{"class":458},[425,2138,2139],{"class":442}," })\n",[425,2141,2142],{"class":427,"line":545},[425,2143,465],{"class":442},[425,2145,2146],{"class":427,"line":554},[425,2147,471],{"class":442},[2149,2150,2151],"tip",{"to":368},"多个处理器、会话、鉴权等高级用法见 MCP Toolkit 文档。",[2153,2154,2155],"style",{},"html pre.shiki code .s8jYJ, html code.shiki .s8jYJ{--shiki-light:#D73A49;--shiki-default:#D73A49;--shiki-dark:#F97583}html pre.shiki code .snPdu, html code.shiki .snPdu{--shiki-light:#6F42C1;--shiki-default:#6F42C1;--shiki-dark:#B392F0}html pre.shiki code .sxrX7, html code.shiki .sxrX7{--shiki-light:#24292E;--shiki-default:#24292E;--shiki-dark:#E1E4E8}html pre.shiki code .sBjJW, html code.shiki .sBjJW{--shiki-light:#005CC5;--shiki-default:#005CC5;--shiki-dark:#79B8FF}html .light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html.light .shiki span {color: var(--shiki-light);background: var(--shiki-light-bg);font-style: var(--shiki-light-font-style);font-weight: var(--shiki-light-font-weight);text-decoration: var(--shiki-light-text-decoration);}html .default .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .shiki span {color: var(--shiki-default);background: var(--shiki-default-bg);font-style: var(--shiki-default-font-style);font-weight: var(--shiki-default-font-weight);text-decoration: var(--shiki-default-text-decoration);}html .dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html.dark .shiki span {color: var(--shiki-dark);background: var(--shiki-dark-bg);font-style: var(--shiki-dark-font-style);font-weight: var(--shiki-dark-font-weight);text-decoration: var(--shiki-dark-text-decoration);}html pre.shiki code .sCsY4, html code.shiki .sCsY4{--shiki-light:#6A737D;--shiki-default:#6A737D;--shiki-dark:#6A737D}html pre.shiki code .sIIMD, html code.shiki .sIIMD{--shiki-light:#032F62;--shiki-default:#032F62;--shiki-dark:#9ECBFF}html pre.shiki code .sP4rz, html code.shiki .sP4rz{--shiki-light:#E36209;--shiki-default:#E36209;--shiki-dark:#FFAB70}",{"title":421,"searchDepth":446,"depth":446,"links":2157},[2158,2162,2169,2177],{"id":396,"depth":446,"text":396,"children":2159},[2160,2161],{"id":400,"depth":452,"text":400},{"id":489,"depth":452,"text":489},{"id":579,"depth":446,"text":579,"children":2163},[2164,2165,2166,2167,2168],{"id":582,"depth":452,"text":582},{"id":783,"depth":452,"text":783},{"id":846,"depth":452,"text":846},{"id":881,"depth":452,"text":881},{"id":903,"depth":452,"text":903},{"id":933,"depth":446,"text":933,"children":2170},[2171,2172,2173,2174,2175,2176],{"id":942,"depth":452,"text":943},{"id":977,"depth":452,"text":978},{"id":1089,"depth":452,"text":1090},{"id":1159,"depth":452,"text":1160},{"id":1234,"depth":452,"text":1235},{"id":1316,"depth":452,"text":1317},{"id":1332,"depth":446,"text":1332,"children":2178},[2179,2180,2181,2182],{"id":1342,"depth":452,"text":1342},{"id":1696,"depth":452,"text":1696},{"id":1907,"depth":452,"text":1907},{"id":2069,"depth":452,"text":2069},"md",{},{"icon":131},{"title":127,"description":2187},"Use the built-in MCP Server of Movk Nuxt Docs to let AI clients search and read your docs, list its tools, connect clients, and extend it.",{"loc":128},"trw33QbOA9EtI_1_UmgMPGQzAFvniUZfZz49pacsNZ4",[2191,2192],{"title":121,"path":122,"stem":123,"description":124,"icon":125,"children":-1},{"title":133,"path":134,"stem":135,"description":136,"icon":137,"children":-1},{"data":2194,"body":2195},{},{"type":341,"children":2196},[2197],{"type":344,"tag":345,"props":2198,"children":2199},{},[2200],{"type":349,"value":130},1794996153009]