Fix docs MCP content fetch on Vercel

[bryantgillespie]

Changes

• Pins Nuxt Content to the native SQLite connector for Vercel compatibility.
• Makes get-doc read generated markdown first, with Nuxt Content query fallback for dev.
• Makes list-docs read the generated static MCP docs index, with Nuxt Content query fallback for dev.
• Adds parser coverage for MCP markdown metadata.

Potential Risks

• Static docs/index fetches now depend on NUXT_PUBLIC_SITE_URL matching the deployed docs origin.

Review Notes

• Verified with Vitest, Vercel build, node-server build, and local built MCP get-doc/list-docs calls.
• Current docs frontmatter uses single-line title/description values; no block-style frontmatter found.
• list-docs loads all dev fallback rows intentionally so pathPrefix filtering happens before limit.

[vercel]

The latest updates on your projects. Learn more about Vercel for GitHub.

Project	Deployment	Actions	Updated (UTC)
docs	Ready	Preview, Comment	Jun 2, 2026 6:29pm

[bryantgillespie]

Updated after preview logs showed Nuxt Content SQLite still initializing in Vercel runtime.

Follow-up fix:

• generate /docs/mcp-docs-index.json at build
• make MCP get-doc fetch public static markdown by absolute same-origin URL
• make MCP list-docs read the static index
• keep Nuxt Content fallback dev-only

Verified: pnpm vitest run tests/server/mcpMarkdown.test.ts, git diff --check, NITRO_PRESET=vercel pnpm build, NITRO_PRESET=node-server pnpm build, local MCP get-doc + list-docs.

[bryantgillespie]

Added native SQLite connector config for Nuxt Content.

Evidence:

• Vercel output now uses node:sqlite / node-sqlite in Nitro.
• No better_sqlite3.node load path in the generated Vercel function.
• Vercel function runtime is nodejs22.x.
• Direct better-sqlite3 dependency was removed from the final PR diff.

Verified locally:

• pnpm vitest run tests/server/mcpMarkdown.test.ts
• NITRO_PRESET=vercel pnpm build
• NITRO_PRESET=node-server pnpm build
• local POST /docs/__nuxt_content/content/query returns 200 with valid SQL
• local POST /docs/mcp get-doc returns 200

Vercel check for 300c2ff9 is still pending as of this comment.