- 流程图（
flowchart/graph）：用于展示流程和决策
- 时序图（
sequenceDiagram）：用于展示交互时序
- 类图（
classDiagram）：用于展示类关系 - 状态图（
stateDiagram）：用于展示状态转换 - 甘特图（
gantt）：用于展示项目时间线 - 饼图（
pie）：用于展示数据占比 - Git 图（
gitGraph）：用于展示分支历史 - 以及更多 Mermaid 支持的图表类型
接入你的智能体
发布者自己的命令。不是 PlugMCP 端点。
用我们的密钥与日志托管一份副本。
npx -y @movk/[email protected]Claude Code 没有针对本地命令的安装链接。复制下方命令并在终端中运行。
claude mcp add movk-nuxt-docs -- npx -y @movk/nuxt-docs@3.0.2在终端中运行。
{ "mcpServers": { "movk-nuxt-docs": { "command": "npx", "args": [ "-y", "@movk/[email protected]" ] } }}claude_desktop_config.json
远程 URL 还是本机命令？ 两种安装方式的区别
基于 Nuxt 4 的现代文档主题，集成组件自动化文档、AI 聊天助手、MCP Server 和完整的开发者体验优化
使用此主题可以快速构建美观、专业、智能的文档网站，内置组件文档自动生成、AI 聊天助手、MCP Server 支持、SEO 优化、暗黑模式、全文搜索等功能。
此主题集成了一系列旨在优化文档管理体验的强大功能：
nuxt-llms 模块自动生成 llms.txt 和 llms-full.txt，为 AI 工具提供优化的文档索引shiki-stream 实现实时语法高亮渲染Agent Skills 是一种开放格式，允许 AI 代理（Claude Code、Cursor、Windsurf 等）自动发现并加载文档站的专属工作流。Movk Nuxt Docs 将 skills/ 目录下的所有技能自动发布到 /.well-known/skills/ 端点。
内置技能：
create-docs - 为任意项目生成基于 Movk Nuxt Docs 的完整文档网站review-docs - 审查文档质量，检查清晰度、SEO 和技术正确性一键安装到 AI 工具：
npx skills add https://docs.mhaibaraai.cn
详见 Agent Skills 文档。
nuxt-component-meta 自动提取 Vue 组件的 Props、Slots、Emits 定义ComponentExample 组件自动加载和渲染组件示例，支持代码高亮和实时预览CommitChangelog 和 PageLastCommit 组件自动展示文件的提交历史记录ContentSearch 组件，支持键盘快捷键（⌘K）@nuxtjs/i18n 的 opt-in 多语言支持，按语言划分内容集合，内置语言切换器与 hreflang SEO根据您的需求选择合适的模板：
适合构建完整的文档网站，包含 ESLint、TypeScript 检查等开发工具。
# 使用完整模板创建新项目
npx nuxi init -t gh:mhaibaraai/movk-nuxt-docs/templates/default my-docs
cd my-docs
pnpm dev
在完整模板基础上启用 @nuxtjs/i18n，内置简体中文与英文两套内容。
npx nuxi init -t gh:mhaibaraai/movk-nuxt-docs/templates/i18n my-docs
cd my-docs
pnpm dev
适合为 npm 包或库创建文档，在完整模板基础上内置 Release 页面展示版本发布历史。
# 使用模块模板创建新项目
npx nuxi init -t gh:mhaibaraai/movk-nuxt-docs/templates/module my-module-docs
cd my-module-docs
pnpm dev
访问 http://localhost:3000 查看你的文档网站。
在现有 Nuxt 项目中使用 Movk Nuxt Docs 作为 layer：
pnpm add @movk/nuxt-docs @nuxt/content tailwindcss
@nuxt/content为 peerDependency，必须安装在应用自身依赖中，否则内容集合类型增强无法解析。
在 nuxt.config.ts 中配置：
export default defineNuxtConfig({
+ extends: ['@movk/nuxt-docs']
})
使用模板创建的项目结构（以 default 模板为例）：
my-docs/
├── app/
│ └── app.config.ts # 页头导航、侧栏分类等运行时配置
├── content/ # Markdown 内容
│ ├── index.md # 首页
│ └── docs/ # 文档页面
├── public/ # 静态资源
├── nuxt.config.ts # Nuxt 配置
├── tsconfig.json # TypeScript 配置
├── package.json # 依赖与脚本
├── .env.example # 环境变量示例
└── pnpm-workspace.yaml # pnpm 工作区配置
本仓库采用 monorepo 结构：
movk-nuxt-docs/
├── docs/ # 官方文档站点
├── layer/ # @movk/nuxt-docs layer 包
├── templates/
│ ├── default/ # 完整文档站点模板
│ ├── i18n/ # 多语言文档站点模板
│ └── module/ # 模块文档站点模板
└── scripts/ # 构建脚本
---
title: 页面标题
description: 页面描述
---
# 标题
这是一段普通的文本内容。
## 二级标题
- 列表项 1
- 列表项 2
::card
---
title: 卡片标题
icon: i-lucide-rocket
---
卡片内容
::
了解更多关于 MDC 语法，请查看 Nuxt Content 文档。
Mermaid 是可选功能，默认不启用。先安装依赖，再开启配置：
pnpm add mermaid dompurify
export default defineNuxtConfig({
extends: ['@movk/nuxt-docs'],
movkNuxtDocs: {
mermaid: true
}
})
启用后，使用 ```mermaid 代码块渲染可视化图表，支持流程图、时序图、类图等多种图表类型：
```mermaid
graph TD
A[开始] --> B{是否有效?}
B -->|是| C[处理数据]
B -->|否| D[显示错误]
C --> E[完成]
D --> E
```
主要特性：
支持的图表类型：
flowchart/graph）：用于展示流程和决策
sequenceDiagram）：用于展示交互时序
classDiagram）：用于展示类关系stateDiagram）：用于展示状态转换gantt）：用于展示项目时间线pie）：用于展示数据占比gitGraph）：用于展示分支历史Movk Nuxt Docs 默认启用 @nuxt/a11y。如需关闭，可在 movkNuxtDocs 中设置：
export default defineNuxtConfig({
extends: ['@movk/nuxt-docs'],
movkNuxtDocs: {
a11y: false
}
})
多语言基于 @nuxtjs/i18n，采用 opt-in 设计：未配置时单语言运行，配置后自动启用本地化路由、按语言划分的内容集合、语言切换器与 hreflang SEO。先安装依赖，再在 nuxt.config.ts 配置 i18n.locales：
pnpm add @nuxtjs/i18n
export default defineNuxtConfig({
extends: ['@movk/nuxt-docs'],
modules: ['@nuxtjs/i18n'],
i18n: {
defaultLocale: 'zh-CN',
locales: [
{ code: 'zh-CN', name: '简体中文', file: 'zh-CN.json' },
{ code: 'en', name: 'English', file: 'en.json' }
]
}
})
默认语言内容保持在 content/ 根目录（无前缀，如 /docs），其余语言放入 content/{locale}/（带前缀，如 /en/docs）。开箱即用可使用官方 i18n 模板：npx nuxi init -t gh:mhaibaraai/movk-nuxt-docs/templates/i18n my-docs。详见 国际化文档。
# 克隆项目
git clone https://github.com/mhaibaraai/movk-nuxt-docs.git
# 进入项目目录
cd movk-nuxt-docs
# 安装依赖
pnpm install
# 启动开发服务器
pnpm dev
开发服务器将在 http://localhost:3000 启动。
# 构建应用
pnpm build
# 本地预览生产构建
pnpm preview
# bump 版本、生成 changelog、打 tag 推送，由 CI 发布到 npm
pnpm release
本项目基于以下优秀的开源项目构建：
访问 Movk Nuxt Docs 文档 了解详细的使用指南和 API 文档。
本项目基于以下优秀项目构建或受其启发：
Modern Nuxt 4 documentation theme with auto-generated component docs, AI chat assistant, MCP server, and complete developer experience optimization.
{ "mcpServers": { "movk-nuxt-docs": { "command": "npx", "args": [ "-y", "@movk/[email protected]" ] } }}工具
暂无工具列表。远程服务器在首次健康检查后会获得工具列表。
常见问题
在本页复制适用于 Cursor、Claude Desktop、Claude Code 或 VS Code 的 stdio 配置。它使用发布者的安装方式，而不是 PlugMCP 代理。
此记录未列出必需的环境变量。
@movk/nuxt Docs 通过 stdio 在本地运行。
上次检查时间：2026-11-09。 Modern Nuxt 4 documentation theme with auto-generated component docs, AI chat assistant, MCP server, and complete developer experience optimization.