fix(mcp): use /raw fetching instead of rawbody

Author: HugoRCD

content.config.ts

@@ -216,26 +216,23 @@ export default defineContentConfig({
       source: [docsV5Source, examplesV5Source],
       schema: z.object({
         titleTemplate: z.string().optional(),
-        links: z.array(Button),
-        rawbody: z.string()
+        links: z.array(Button)
       })
     }),
     docsv4: defineCollection({
       type: 'page',
       source: [docsV4Source, examplesV4Source],
       schema: z.object({
         titleTemplate: z.string().optional(),
-        links: z.array(Button),
-        rawbody: z.string()
+        links: z.array(Button)
       })
     }),
     docsv3: defineCollection({
       type: 'page',
       source: [docsV3Source, examplesV3Source],
       schema: z.object({
         titleTemplate: z.string().optional(),
-        links: z.array(Button),
-        rawbody: z.string()
+        links: z.array(Button)
       })
     }),
     blog: defineCollection({
@@ -247,8 +244,7 @@ export default defineContentConfig({
         date: z.string().date(),
         draft: z.boolean().default(false),
         category: z.enum(['Release', 'Tutorial', 'Announcement', 'Article']),
-        tags: z.array(z.string()),
-        rawbody: z.string()
+        tags: z.array(z.string())
       })
     }),
     landing: defineCollection({
@@ -279,8 +275,7 @@ export default defineContentConfig({
         logoIcon: z.string(),
         category: z.string(),
         nitroPreset: z.string(),
-        website: z.string().url(),
-        rawbody: z.string()
+        website: z.string().url()
       })
     }),
     manualSponsors: defineCollection({

server/mcp/prompts/deployment-guide.ts

@@ -10,7 +10,7 @@ export default defineMcpPrompt({
     const event = useEvent()
 
     const deployProviders = await queryCollection(event, 'deploy')
-      .select('title', 'path', 'description', 'rawbody', 'logoSrc', 'logoIcon', 'category', 'nitroPreset', 'website', 'sponsor')
+      .select('title', 'path', 'description')
       .all()
 
     const allProviders = deployProviders?.map(p => ({
@@ -24,20 +24,12 @@ export default defineMcpPrompt({
       p.title.toLowerCase().includes(provider.toLowerCase())
     )
 
-    let providerDetails = null
+    let providerContent: string | null = null
     if (matchingProvider) {
-      providerDetails = {
-        title: matchingProvider.title,
-        path: matchingProvider.path,
-        description: matchingProvider.description,
-        content: matchingProvider.rawbody,
-        logoSrc: matchingProvider.logoSrc,
-        logoIcon: matchingProvider.logoIcon,
-        category: matchingProvider.category,
-        nitroPreset: matchingProvider.nitroPreset,
-        website: matchingProvider.website,
-        sponsor: matchingProvider.sponsor,
-        url: `https://nuxt.com${matchingProvider.path}`
+      try {
+        providerContent = await $fetch<string>(`/raw${matchingProvider.path}.md`)
+      } catch {
+        providerContent = null
       }
     }
 
@@ -47,7 +39,7 @@ export default defineMcpPrompt({
           role: 'user' as const,
           content: {
             type: 'text' as const,
-            text: `Help me deploy my Nuxt application to ${provider}. ${providerDetails ? `Here are the deployment instructions: ${JSON.stringify(providerDetails, null, 2)}` : `Here are all available providers: ${JSON.stringify(allProviders, null, 2)}`}`
+            text: `Help me deploy my Nuxt application to ${provider}. ${providerContent ? `Here are the deployment instructions:\n\n${providerContent}` : `Here are all available providers: ${JSON.stringify(allProviders, null, 2)}`}`
           }
         }
       ]

server/mcp/tools/get-blog-post.ts

@@ -1,5 +1,4 @@
 import { z } from 'zod'
-import { queryCollection } from '@nuxt/content/server'
 
 export default defineMcpTool({
   description: `Retrieves the full content and details of a specific Nuxt blog post.
@@ -13,32 +12,24 @@ WHEN NOT TO USE: If you don't know the exact path and need to search/discover, u
 
 EXAMPLES: "/blog/v4", "/blog/nuxt3", "/blog/nuxt-on-the-edge"`,
   inputSchema: {
-    path: z.string().describe('The path to the blog post (e.g., /blog/v4)')
+    path: z.string().describe('The path to the blog post (e.g., /blog/v4)'),
+    sections: z.array(z.string()).optional().describe('Specific h2 section titles to return. If omitted, returns full content.')
   },
   cache: '1h',
-  async handler({ path }) {
-    const event = useEvent()
+  async handler({ path, sections }) {
+    try {
+      const fullContent = await $fetch<string>(`/raw${path}.md`)
 
-    const post = await queryCollection(event, 'blog')
-      .where('path', '=', path)
-      .select('title', 'path', 'description', 'rawbody', 'date', 'category', 'tags', 'authors', 'image')
-      .first()
+      let content = fullContent
+      if (sections?.length) {
+        content = extractSections(fullContent, sections)
+      }
 
-    if (!post) {
-      return errorResult('Blog post not found')
+      return {
+        content: [{ type: 'text' as const, text: content }]
+      }
+    } catch (error) {
+      return errorResult(`Blog post not found: ${error}`)
     }
-
-    return jsonResult({
-      title: post.title,
-      path: post.path,
-      description: post.description,
-      content: post.rawbody,
-      date: post.date,
-      category: post.category,
-      tags: post.tags,
-      authors: post.authors,
-      image: post.image,
-      url: `https://nuxt.com${post.path}`
-    })
   }
 })

server/mcp/tools/get-deploy-provider.ts

@@ -1,5 +1,4 @@
 import { z } from 'zod'
-import { queryCollection } from '@nuxt/content/server'
 
 export default defineMcpTool({
   description: `Retrieves detailed deployment instructions and setup guide for a specific hosting provider.
@@ -13,33 +12,24 @@ WHEN NOT TO USE: If the user is asking about options or comparing providers, use
 
 EXAMPLES: "/deploy/vercel", "/deploy/cloudflare", "/deploy/netlify", "/deploy/aws", "/deploy/node-server"`,
   inputSchema: {
-    path: z.string().describe('The path to the deploy provider (e.g., /deploy/vercel)')
+    path: z.string().describe('The path to the deploy provider (e.g., /deploy/vercel)'),
+    sections: z.array(z.string()).optional().describe('Specific h2 section titles to return. If omitted, returns full content.')
   },
   cache: '1h',
-  async handler({ path }) {
-    const event = useEvent()
+  async handler({ path, sections }) {
+    try {
+      const fullContent = await $fetch<string>(`/raw${path}.md`)
 
-    const provider = await queryCollection(event, 'deploy')
-      .where('path', '=', path)
-      .select('title', 'path', 'description', 'rawbody', 'logoSrc', 'logoIcon', 'category', 'nitroPreset', 'website', 'sponsor')
-      .first()
+      let content = fullContent
+      if (sections?.length) {
+        content = extractSections(fullContent, sections)
+      }
 
-    if (!provider) {
-      return errorResult('Deploy provider not found')
+      return {
+        content: [{ type: 'text' as const, text: content }]
+      }
+    } catch (error) {
+      return errorResult(`Deploy provider not found: ${error}`)
     }
-
-    return jsonResult({
-      title: provider.title,
-      path: provider.path,
-      description: provider.description,
-      content: provider.rawbody,
-      logoSrc: provider.logoSrc,
-      logoIcon: provider.logoIcon,
-      category: provider.category,
-      nitroPreset: provider.nitroPreset,
-      website: provider.website,
-      sponsor: provider.sponsor,
-      url: `https://nuxt.com${provider.path}`
-    })
   }
 })

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

@@ -1,4 +1,3 @@
-import { queryCollection } from '@nuxt/content/server'
 import { z } from 'zod'
 
 export default defineMcpTool({
@@ -31,30 +30,24 @@ Common Issues:
 - "/docs/4.x/guide/going-further/debugging" - debugging
 - "/docs/4.x/guide/going-further/error-handling" - errors`,
   inputSchema: {
-    path: z.string().describe('The path to the documentation page (e.g., /docs/4.x/getting-started/introduction)')
+    path: z.string().describe('The path to the documentation page (e.g., /docs/4.x/getting-started/introduction)'),
+    sections: z.array(z.string()).optional().describe('Specific h2 section titles to return (e.g., ["Usage", "API"]). If omitted, returns full documentation.')
   },
   cache: '30m',
-  async handler({ path }) {
-    const event = useEvent()
-    const docsVersion = path.includes('/docs/5.x') ? 'docsv5' : path.includes('/docs/4.x') ? 'docsv4' : 'docsv3'
-
-    const page = await queryCollection(event, docsVersion)
-      .where('path', '=', path)
-      .select('title', 'path', 'description', 'rawbody', 'links')
-      .first()
-
-    if (!page) {
-      return errorResult('Documentation page not found')
+  async handler({ path, sections }) {
+    try {
+      const fullContent = await $fetch<string>(`/raw${path}.md`)
+
+      let content = fullContent
+      if (sections?.length) {
+        content = extractSections(fullContent, sections)
+      }
+
+      return {
+        content: [{ type: 'text' as const, text: content }]
+      }
+    } catch (error) {
+      return errorResult(`Documentation page not found: ${error}`)
     }
-
-    return jsonResult({
-      title: page.title,
-      path: page.path,
-      description: page.description,
-      content: page.rawbody,
-      version: page.path.includes('/docs/5.x') ? '5.x' : page.path.includes('/docs/4.x') ? '4.x' : '3.x',
-      links: page.links,
-      url: `https://nuxt.com${page.path}`
-    })
   }
 })

server/mcp/tools/get-getting-started-guide.ts

@@ -1,35 +1,29 @@
 import { z } from 'zod'
-import { queryCollection } from '@nuxt/content/server'
 
 export default defineMcpTool({
   description: 'Gets the getting started guide for Nuxt. Parameters: version (enum, optional) - Nuxt version.',
   inputSchema: {
     // TODO: add '5.x' when Nuxt 5 is released
-    version: z.enum(['3.x', '4.x']).optional().default('4.x').describe('Nuxt version')
+    version: z.enum(['3.x', '4.x']).optional().default('4.x').describe('Nuxt version'),
+    sections: z.array(z.string()).optional().describe('Specific h2 section titles to return. If omitted, returns full guide.')
   },
   cache: '30m',
-  async handler({ version }) {
-    const event = useEvent()
+  async handler({ version, sections }) {
     const path = `/docs/${version}/getting-started/introduction`
-    const docsVersion = version === '4.x' ? 'docsv4' : 'docsv3'
 
-    const page = await queryCollection(event, docsVersion)
-      .where('path', '=', path)
-      .select('title', 'path', 'description', 'rawbody', 'links')
-      .first()
+    try {
+      const fullContent = await $fetch<string>(`/raw${path}.md`)
 
-    if (!page) {
-      return errorResult('Getting started guide not found')
-    }
+      let content = fullContent
+      if (sections?.length) {
+        content = extractSections(fullContent, sections)
+      }
 
-    return jsonResult({
-      title: page.title,
-      path: page.path,
-      description: page.description,
-      content: page.rawbody,
-      version: version,
-      links: page.links,
-      url: `https://nuxt.com${page.path}`
-    })
+      return {
+        content: [{ type: 'text' as const, text: content }]
+      }
+    } catch (error) {
+      return errorResult(`Getting started guide not found: ${error}`)
+    }
   }
 })

server/utils/mcp.ts

@@ -0,0 +1,48 @@
+/**
+ * Extract specific h2 sections from markdown content.
+ * Always includes the title (h1) and description (first blockquote).
+ */
+export function extractSections(markdown: string, sectionTitles: string[]): string {
+  const lines = markdown.split('\n')
+  const result: string[] = []
+
+  const normalizedTitles = sectionTitles.map(t => t.toLowerCase().trim())
+
+  let inHeader = true
+  for (const line of lines) {
+    if (inHeader) {
+      result.push(line)
+      if (line.startsWith('>') && result.length > 1) {
+        result.push('')
+        inHeader = false
+      }
+      continue
+    }
+    break
+  }
+
+  let currentSection: string | null = null
+  let sectionContent: string[] = []
+
+  for (const line of lines) {
+    if (line.startsWith('## ')) {
+      if (currentSection && normalizedTitles.includes(currentSection.toLowerCase())) {
+        result.push(...sectionContent)
+        result.push('')
+      }
+      currentSection = line.replace('## ', '').trim()
+      sectionContent = [line]
+      continue
+    }
+
+    if (currentSection) {
+      sectionContent.push(line)
+    }
+  }
+
+  if (currentSection && normalizedTitles.includes(currentSection.toLowerCase())) {
+    result.push(...sectionContent)
+  }
+
+  return result.join('\n').trim()
+}