docus 5.3.1 → 5.4.1

package/app/app.vue

@@ -53,6 +53,7 @@ const { data: navigation } = await useAsyncData(() => `navigation_${collectionNa
 })
 const { data: files } = useLazyAsyncData(`search_${collectionName.value}`, () => queryCollectionSearchSections(collectionName.value as keyof PageCollections), {
   server: false,
+  watch: [locale],
 })
 
 provide('navigation', navigation)

package/app/components/OgImage/OgImageDocs.vue

@@ -1,4 +1,6 @@
 <script lang="ts" setup>
+import { computed } from 'vue'
+
 const props = withDefaults(defineProps<{ title?: string, description?: string, headline?: string }>(), {
   title: 'title',
   description: 'description',

package/app/components/OgImage/OgImageLanding.vue

@@ -1,4 +1,6 @@
 <script lang="ts" setup>
+import { computed } from 'vue'
+
 const props = withDefaults(defineProps<{ title?: string, description?: string, headline?: string }>(), {
   title: 'title',
   description: 'description',

package/app/components/docs/DocsPageHeaderLinks.vue

@@ -1,12 +1,14 @@
 <script setup lang="ts">
 import { useClipboard } from '@vueuse/core'
+import { useRuntimeConfig } from '#imports'
 
 const route = useRoute()
+const appBaseURL = useRuntimeConfig().app?.baseURL || '/'
 
 const { copy, copied } = useClipboard()
 const { t } = useDocusI18n()
 
-const markdownLink = computed(() => `${window?.location?.origin}/raw${route.path}.md`)
+const markdownLink = computed(() => `${window?.location?.origin}${appBaseURL}raw${route.path}.md`)
 const items = [
   {
     label: t('docs.copy.link'),

package/nuxt.config.ts

@@ -11,6 +11,7 @@ export default defineNuxtConfig({
     '@nuxt/content',
     '@nuxt/image',
     '@nuxtjs/robots',
+    '@nuxtjs/mcp-toolkit',
     'nuxt-og-image',
     'nuxt-llms',
     () => {
@@ -43,6 +44,9 @@ export default defineNuxtConfig({
       },
     },
   },
+  experimental: {
+    asyncContext: true,
+  },
   compatibilityDate: '2025-07-22',
   nitro: {
     prerender: {

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "docus",
   "description": "Nuxt layer for Docus documentation theme",
-  "version": "5.3.1",
+  "version": "5.4.1",
   "type": "module",
   "main": "./nuxt.config.ts",
   "repository": {
@@ -22,16 +22,17 @@
     "README.md"
   ],
   "dependencies": {
-    "@iconify-json/lucide": "^1.2.75",
-    "@iconify-json/simple-icons": "^1.2.60",
-    "@iconify-json/vscode-icons": "^1.2.36",
-    "@nuxt/content": "^3.8.2",
+    "@iconify-json/lucide": "^1.2.81",
+    "@iconify-json/simple-icons": "^1.2.63",
+    "@iconify-json/vscode-icons": "^1.2.37",
+    "@nuxt/content": "^3.9.0",
     "@nuxt/image": "^2.0.0",
-    "@nuxt/kit": "^4.2.1",
-    "@nuxt/ui": "^4.2.1",
+    "@nuxt/kit": "^4.2.2",
+    "@nuxt/ui": "^4.3.0",
     "@nuxtjs/i18n": "^10.2.1",
-    "@nuxtjs/mdc": "^0.18.4",
-    "@nuxtjs/robots": "^5.5.6",
+    "@nuxtjs/mcp-toolkit": "^0.5.2",
+    "@nuxtjs/mdc": "^0.19.1",
+    "@nuxtjs/robots": "^5.6.7",
     "@vueuse/core": "^13.9.0",
     "defu": "^6.1.4",
     "exsolve": "^1.0.8",
@@ -39,11 +40,13 @@
     "minimark": "^0.2.0",
     "motion-v": "^1.7.4",
     "nuxt-llms": "^0.1.3",
-    "nuxt-og-image": "^5.1.12",
+    "nuxt-og-image": "^5.1.13",
     "pkg-types": "^2.3.0",
     "scule": "^1.3.0",
-    "tailwindcss": "^4.1.17",
-    "ufo": "^1.6.1"
+    "tailwindcss": "^4.1.18",
+    "ufo": "^1.6.1",
+    "zod": "^4.2.1",
+    "zod-to-json-schema": "^3.25.0"
   },
   "peerDependencies": {
     "better-sqlite3": "12.x",

package/server/mcp/tools/get-page.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod'
+import { queryCollection } from '@nuxt/content/server'
+import type { Collections } from '@nuxt/content'
+import { getAvailableLocales, getCollectionFromPath } from '../../utils/content'
+import { inferSiteURL } from '../../../utils/meta'
+
+export default defineMcpTool({
+  description: `Retrieves the full content and details of a specific documentation page.
+
+WHEN TO USE: Use this tool when you know the EXACT path to a documentation page. Common use cases:
+- User asks for a specific page: "Show me the getting started guide" → /en/getting-started/installation
+- User asks about a known topic with a dedicated page
+- You found a relevant path from list-pages and want the full content
+- User references a specific section or guide they want to read
+
+WHEN NOT TO USE: If you don't know the exact path and need to search/explore, use list-pages first.
+
+WORKFLOW: This tool returns the complete page content including title, description, and full markdown. Use this when you need to provide detailed answers or code examples from specific documentation pages.
+`,
+  inputSchema: {
+    path: z.string().describe('The page path from list-pages or provided by the user (e.g., /en/getting-started/installation)'),
+  },
+  cache: '1h',
+  handler: async ({ path }) => {
+    const event = useEvent()
+    const config = useRuntimeConfig(event).public
+    const siteUrl = import.meta.dev ? 'http://localhost:3000' : inferSiteURL()
+
+    const availableLocales = getAvailableLocales(config)
+    const collectionName = config.i18n?.locales
+      ? getCollectionFromPath(path, availableLocales)
+      : 'docs'
+
+    try {
+      const page = await queryCollection(event, collectionName as keyof Collections)
+        .where('path', '=', path)
+        .select('title', 'path', 'description')
+        .first()
+
+      if (!page) {
+        return errorResult('Page not found')
+      }
+
+      const content = await $fetch<string>(`/raw${path}.md`, {
+        baseURL: siteUrl,
+      })
+
+      return jsonResult({
+        title: page.title,
+        path: page.path,
+        description: page.description,
+        content,
+        url: `${siteUrl}${page.path}`,
+      })
+    }
+    catch {
+      return errorResult('Failed to get page')
+    }
+  },
+})

package/server/mcp/tools/list-pages.ts

@@ -0,0 +1,60 @@
+import { z } from 'zod'
+import { queryCollection } from '@nuxt/content/server'
+import type { Collections } from '@nuxt/content'
+import { getCollectionsToQuery, getAvailableLocales } from '../../utils/content'
+
+export default defineMcpTool({
+  description: `Lists all available documentation pages with their categories and basic information.
+
+WHEN TO USE: Use this tool when you need to EXPLORE or SEARCH for documentation about a topic but don't know the exact page path. Common scenarios:
+- "Find documentation about markdown features" - explore available guides
+- "Show me all getting started guides" - browse introductory content
+- "Search for advanced configuration options" - find specific topics
+- User asks general questions without specifying exact pages
+- You need to understand the overall documentation structure
+
+WHEN NOT TO USE: If you already know the specific page path (e.g., "/en/getting-started/installation"), use get-page directly instead.
+
+WORKFLOW: This tool returns page titles, descriptions, and paths. After finding relevant pages, use get-page to retrieve the full content of specific pages that match the user's needs.
+
+OUTPUT: Returns a structured list with:
+- title: Human-readable page name
+- path: Exact path for use with get-page
+- description: Brief summary of page content
+- url: Full URL for reference`,
+  inputSchema: {
+    locale: z.string().optional().describe('The locale to filter pages by'),
+  },
+  cache: '1h',
+  handler: async ({ locale }) => {
+    const event = useEvent()
+    const config = useRuntimeConfig(event).public
+
+    const siteUrl = import.meta.dev ? 'http://localhost:3000' : getRequestURL(event).origin
+    const availableLocales = getAvailableLocales(config)
+    const collections = getCollectionsToQuery(locale, availableLocales)
+
+    try {
+      const allPages = await Promise.all(
+        collections.map(async (collectionName) => {
+          const pages = await queryCollection(event, collectionName as keyof Collections)
+            .select('title', 'path', 'description')
+            .all()
+
+          return pages.map(page => ({
+            title: page.title,
+            path: page.path,
+            description: page.description,
+            locale: collectionName.replace('docs_', ''),
+            url: `${siteUrl}${page.path}`,
+          }))
+        }),
+      )
+
+      return jsonResult(allPages.flat())
+    }
+    catch {
+      return errorResult('Failed to list pages')
+    }
+  },
+})

package/server/routes/raw/[...slug].md.get.ts

@@ -1,6 +1,6 @@
 import { withLeadingSlash } from 'ufo'
 import { stringify } from 'minimark/stringify'
-import { queryCollection } from '@nuxt/content/nitro'
+import { queryCollection } from '@nuxt/content/server'
 import type { Collections } from '@nuxt/content'
 
 export default eventHandler(async (event) => {

package/server/utils/content.ts

@@ -0,0 +1,37 @@
+import type { LocaleObject } from '@nuxtjs/i18n'
+
+type ConfigWithLocales = {
+  i18n?: { locales?: Array<string | LocaleObject> }
+  docus?: { filteredLocales?: LocaleObject<string>[] }
+}
+
+export function getAvailableLocales(config: ConfigWithLocales): string[] {
+  if (config.docus?.filteredLocales) {
+    return config.docus.filteredLocales.map(locale => locale.code)
+  }
+
+  return config.i18n?.locales
+    ? config.i18n.locales.map(locale => typeof locale === 'string' ? locale : locale.code)
+    : []
+}
+
+export function getCollectionsToQuery(locale: string | undefined, availableLocales: string[]): string[] {
+  if (locale && availableLocales.includes(locale)) {
+    return [`docs_${locale}`]
+  }
+
+  return availableLocales.length > 0
+    ? availableLocales.map(l => `docs_${l}`)
+    : ['docs']
+}
+
+export function getCollectionFromPath(path: string, availableLocales: string[]): string {
+  const pathSegments = path.split('/').filter(Boolean)
+  const firstSegment = pathSegments[0]
+
+  if (firstSegment && availableLocales.includes(firstSegment)) {
+    return `docs_${firstSegment}`
+  }
+
+  return 'docs'
+}