@docsector/docsector-reader 0.8.4 → 0.9.0

package/README.md

@@ -24,6 +24,9 @@ Transform Markdown content into beautiful, navigable documentation sites — wit
 - 📄 **View as Markdown** — Open any page as plain text by appending `.md` to the URL, with locale support (`?lang=`)
 - 🤖 **Open in ChatGPT / Claude** — One-click links to open the current page directly in ChatGPT or Claude for Q&A
 - 🤖 **LLM Bot Detection** — Automatically serves raw Markdown to known AI crawlers (GPTBot, ClaudeBot, PerplexityBot, GrokBot, and others)
+- 🗺️ **Sitemap Generation** — Automatic `sitemap.xml` generation at build time with all page URLs (requires `siteUrl` in config)
+- 🤖 **AI-Friendly robots.txt** — Scaffold includes a `robots.txt` explicitly allowing 23 AI crawlers (GPTBot, ClaudeBot, PerplexityBot, GrokBot, etc.)
+- 🔌 **MCP Server** — Auto-generated [MCP](https://modelcontextprotocol.io) server at `/mcp` for AI assistant integration (Claude Desktop, VS Code, etc.)
 
 ---
 
@@ -45,6 +48,86 @@ Transform Markdown content into beautiful, navigable documentation sites — wit
 
 ---
 
+## 🔌 MCP Server (Model Context Protocol)
+
+Docsector Reader can automatically generate an [MCP](https://modelcontextprotocol.io) server at `/mcp` during build, allowing AI assistants like Claude to search and read your documentation in real time.
+
+### Enable MCP
+
+Add `mcp` to your `docsector.config.js`:
+
+```javascript
+export default {
+  // ... other config ...
+
+  mcp: {
+    serverName: 'my-docs',       // MCP server identifier
+    toolSuffix: 'my_docs'        // Tool name suffix (e.g. search_my_docs)
+  },
+
+  siteUrl: 'https://my-docs.example.com'  // Required for MCP URLs
+}
+```
+
+### What the build generates
+
+When `mcp` is configured, `docsector build` generates:
+
+| File | Purpose |
+|---|---|
+| `dist/spa/mcp-pages.json` | Page index (title, path, type) for search |
+| `functions/mcp.js` | Cloudflare Pages Function implementing MCP |
+| `dist/spa/_routes.json` | Routes `/mcp` to the function |
+| `dist/spa/_headers` | CORS headers for MCP endpoint |
+
+### Exposed tools
+
+| Tool | Description |
+|---|---|
+| `search_{suffix}` | Search documentation by keyword, returns matching pages |
+| `get_page_{suffix}` | Get full Markdown content of a specific page |
+
+### Test locally
+
+```bash
+npx docsector build
+npx wrangler pages dev dist/spa
+
+# In another terminal:
+curl http://localhost:8788/mcp
+curl -X POST http://localhost:8788/mcp \
+  -H 'Content-Type: application/json' \
+  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
+```
+
+### Configure in AI assistants
+
+**VS Code** (`mcp.json`):
+```json
+{
+  "servers": {
+    "my-docs": {
+      "type": "http",
+      "url": "https://my-docs.example.com/mcp"
+    }
+  }
+}
+```
+
+**Claude Desktop** (`claude_desktop_config.json`):
+```json
+{
+  "mcpServers": {
+    "my-docs": {
+      "type": "url",
+      "url": "https://my-docs.example.com/mcp"
+    }
+  }
+}
+```
+
+---
+
 ## 🚀 Quick Start
 
 ### 📦 Install
@@ -189,6 +272,16 @@ export default {
 }
 ```
 
+### MCP (optional)
+
+```javascript
+  // Enable MCP server at /mcp
+  mcp: {
+    serverName: 'my-project',   // Server identifier
+    toolSuffix: 'my_project'    // Tool name suffix
+  }
+```
+
 ---
 
 ## 🌍 Internationalization

package/bin/docsector.js

@@ -23,7 +23,7 @@ const packageRoot = resolve(__dirname, '..')
 const args = process.argv.slice(2)
 const command = args[0]
 
-const VERSION = '0.8.4'
+const VERSION = '0.9.0'
 
 const HELP = `
   Docsector Reader v${VERSION}
@@ -125,6 +125,14 @@ export default {
     editBaseUrl: 'https://github.com/your-org/your-repo/edit/main/src/pages'
   },
 
+  // @ MCP (Model Context Protocol)
+  // Uncomment to enable an MCP server at /mcp for AI assistant integration.
+  // Requires Cloudflare Pages Functions (or compatible serverless platform).
+  // mcp: {
+  //   serverName: 'my-docs',
+  //   toolSuffix: 'my_docs'
+  // },
+
   // @ Languages
   languages: [
     {
@@ -681,6 +689,7 @@ const TEMPLATE_GITIGNORE = `\
 node_modules
 .quasar
 dist
+functions
 npm-debug.log*
 .DS_Store
 .thumbs.db

package/docsector.config.js

@@ -35,6 +35,12 @@ export default {
     editBaseUrl: 'https://github.com/docsector/docsector-reader/edit/main/src/pages'
   },
 
+  // @ MCP
+  mcp: {
+    serverName: 'docsector-docs',
+    toolSuffix: 'docsector'
+  },
+
   // @ Languages
   languages: [
     {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@docsector/docsector-reader",
-  "version": "0.8.4",
+  "version": "0.9.0",
   "description": "A documentation rendering engine built with Vue 3, Quasar v2 and Vite. Transform Markdown into beautiful, navigable documentation sites.",
   "productName": "Docsector Reader",
   "author": "Rodrigo de Araujo Vieira",

package/src/components/DPageBar.vue

@@ -5,6 +5,7 @@ import { useStore } from 'vuex'
 import { useI18n } from 'vue-i18n'
 import { copyToClipboard, useQuasar } from 'quasar'
 
+import docsectorConfig from 'docsector.config.js'
 import gitDates from 'virtual:docsector-git-dates'
 
 const $q = useQuasar()
@@ -17,10 +18,12 @@ const copied = ref(false)
 const OPENAI_PATH = 'M22.282 9.821a5.985 5.985 0 0 0-.516-4.91 6.046 6.046 0 0 0-6.51-2.9A6.065 6.065 0 0 0 4.981 4.18a5.985 5.985 0 0 0-3.998 2.9 6.046 6.046 0 0 0 .743 7.097 5.98 5.98 0 0 0 .51 4.911 6.051 6.051 0 0 0 6.515 2.9A5.985 5.985 0 0 0 13.26 24a6.056 6.056 0 0 0 5.772-4.206 5.99 5.99 0 0 0 3.997-2.9 6.056 6.056 0 0 0-.747-7.073zM13.26 22.43a4.476 4.476 0 0 1-2.876-1.04l.141-.081 4.779-2.758a.795.795 0 0 0 .392-.681v-6.737l2.02 1.168a.071.071 0 0 1 .038.052v5.583a4.504 4.504 0 0 1-4.494 4.494zM3.6 18.304a4.47 4.47 0 0 1-.535-3.014l.142.085 4.783 2.759a.771.771 0 0 0 .78 0l5.843-3.369v2.332a.08.08 0 0 1-.033.062L9.74 19.95a4.5 4.5 0 0 1-6.14-1.646zM2.34 7.896a4.485 4.485 0 0 1 2.366-1.973V11.6a.766.766 0 0 0 .388.676l5.815 3.355-2.02 1.168a.076.076 0 0 1-.071 0l-4.83-2.786A4.504 4.504 0 0 1 2.34 7.872zm16.597 3.855l-5.833-3.387L15.119 7.2a.076.076 0 0 1 .071 0l4.83 2.791a4.494 4.494 0 0 1-.676 8.105v-5.678a.79.79 0 0 0-.407-.667zm2.01-3.023l-.141-.085-4.774-2.782a.776.776 0 0 0-.785 0L9.409 9.23V6.897a.066.066 0 0 1 .028-.061l4.83-2.787a4.5 4.5 0 0 1 6.68 4.66zm-12.64 4.135l-2.02-1.164a.08.08 0 0 1-.038-.057V6.075a4.5 4.5 0 0 1 7.375-3.453l-.142.08L8.704 5.46a.795.795 0 0 0-.393.681zm1.097-2.365l2.602-1.5 2.607 1.5v2.999l-2.597 1.5-2.607-1.5z'
 const CLAUDE_PATH = 'M4.709 15.955l4.72-2.647.08-.23-.08-.128H9.2l-.79-.048-2.698-.073-2.339-.097-2.266-.122-.571-.121L0 11.784l.055-.352.48-.321.686.06 1.52.103 2.278.158 1.652.097 2.449.255h.389l.055-.157-.134-.098-.103-.097-2.358-1.596-2.552-1.688-1.336-.972-.724-.491-.364-.462-.158-1.008.656-.722.881.06.225.061.893.686 1.908 1.476 2.491 1.833.365.304.145-.103.019-.073-.164-.274-1.355-2.446-1.446-2.49-.644-1.032-.17-.619a2.97 2.97 0 01-.104-.729L6.283.134 6.696 0l.996.134.42.364.62 1.414 1.002 2.229 1.555 3.03.456.898.243.832.091.255h.158V9.01l.128-1.706.237-2.095.23-2.695.08-.76.376-.91.747-.492.584.28.48.685-.067.444-.286 1.851-.559 2.903-.364 1.942h.212l.243-.242.985-1.306 1.652-2.064.73-.82.85-.904.547-.431h1.033l.76 1.129-.34 1.166-1.064 1.347-.881 1.142-1.264 1.7-.79 1.36.073.11.188-.02 2.856-.606 1.543-.28 1.841-.315.833.388.091.395-.328.807-1.969.486-2.309.462-3.439.813-.042.03.049.061 1.549.146.662.036h1.622l3.02.225.79.522.474.638-.079.485-1.215.62-1.64-.389-3.829-.91-1.312-.329h-.182v.11l1.093 1.068 2.006 1.81 2.509 2.33.127.578-.322.455-.34-.049-2.205-1.657-.851-.747-1.926-1.62h-.128v.17l.444.649 2.345 3.521.122 1.08-.17.353-.608.213-.668-.122-1.374-1.925-1.415-2.167-1.143-1.943-.14.08-.674 7.254-.316.37-.729.28-.607-.461-.322-.747.322-1.476.389-1.924.315-1.53.286-1.9.17-.632-.012-.042-.14.018-1.434 1.967-2.18 2.945-1.726 1.845-.414.164-.717-.37.067-.662.401-.589 2.388-3.036 1.44-1.882.93-1.086-.006-.158h-.055L4.132 18.56l-1.13.146-.487-.456.061-.746.231-.243 1.908-1.312-.006.006z'
 
-function buildIconURI (path, fillRule) {
+function buildIconURI (paths, fillRule) {
   const fill = $q.dark.isActive ? '#ccc' : '#555'
   const fr = fillRule ? ` fill-rule="${fillRule}"` : ''
-  const svg = `<svg xmlns="http://www.w3.org/2000/svg" fill="${fill}"${fr} viewBox="0 0 24 24"><path d="${path}"/></svg>`
+  const pathArr = Array.isArray(paths) ? paths : [paths]
+  const pathEls = pathArr.map(d => `<path d="${d}"/>`).join('')
+  const svg = `<svg xmlns="http://www.w3.org/2000/svg" fill="${fill}"${fr} viewBox="0 0 24 24">${pathEls}</svg>`
   return `img:data:image/svg+xml,${encodeURIComponent(svg)}`
 }
 
@@ -85,6 +88,17 @@ const claudeURL = computed(() => {
   return `https://claude.ai/new?q=${encodeURIComponent(prompt)}`
 })
 
+const MCP_PATHS = [
+  'M15.688 2.343a2.588 2.588 0 00-3.61 0l-9.626 9.44a.863.863 0 01-1.203 0 .823.823 0 010-1.18l9.626-9.44a4.313 4.313 0 016.016 0 4.116 4.116 0 011.204 3.54 4.3 4.3 0 013.609 1.18l.05.05a4.115 4.115 0 010 5.9l-8.706 8.537a.274.274 0 000 .393l1.788 1.754a.823.823 0 010 1.18.863.863 0 01-1.203 0l-1.788-1.753a1.92 1.92 0 010-2.754l8.706-8.538a2.47 2.47 0 000-3.54l-.05-.049a2.588 2.588 0 00-3.607-.003l-7.172 7.034-.002.002-.098.097a.863.863 0 01-1.204 0 .823.823 0 010-1.18l7.273-7.133a2.47 2.47 0 00-.003-3.537z',
+  'M14.485 4.703a.823.823 0 000-1.18.863.863 0 00-1.204 0l-7.119 6.982a4.115 4.115 0 000 5.9 4.314 4.314 0 006.016 0l7.12-6.982a.823.823 0 000-1.18.863.863 0 00-1.204 0l-7.119 6.982a2.588 2.588 0 01-3.61 0 2.47 2.47 0 010-3.54l7.12-6.982z'
+]
+const mcpIcon = computed(() => buildIconURI(MCP_PATHS, 'evenodd'))
+
+const mcpURL = computed(() => {
+  if (!docsectorConfig.mcp) return null
+  return `${window.location.origin}/mcp`
+})
+
 const copyPage = () => {
   if (!rawMarkdown.value) return
 
@@ -163,6 +177,23 @@ const copyPage = () => {
           <q-icon name="open_in_new" size="xs" />
         </q-item-section>
       </q-item>
+
+      <template v-if="mcpURL">
+        <q-separator />
+
+        <q-item clickable v-close-popup :href="mcpURL" target="_blank" class="q-py-sm">
+          <q-item-section avatar>
+            <q-icon :name="mcpIcon" size="xs" />
+          </q-item-section>
+          <q-item-section>
+            <q-item-label>{{ t('page.mcpServer') }}</q-item-label>
+            <q-item-label caption>{{ t('page.mcpServerCaption') }}</q-item-label>
+          </q-item-section>
+          <q-item-section side>
+            <q-icon name="open_in_new" size="xs" />
+          </q-item-section>
+        </q-item>
+      </template>
     </q-list>
   </q-btn-dropdown>
 </div>

package/src/i18n/helpers.js

@@ -33,7 +33,9 @@ const engineDefaults = {
       openInChatGPT: 'Open in ChatGPT',
       openInChatGPTCaption: 'Ask ChatGPT about this page',
       openInClaude: 'Open in Claude',
-      openInClaudeCaption: 'Ask Claude about this page'
+      openInClaudeCaption: 'Ask Claude about this page',
+      mcpServer: 'MCP Server',
+      mcpServerCaption: 'Connect AI assistants via MCP'
     }
   },
   'pt-BR': {
@@ -47,7 +49,9 @@ const engineDefaults = {
       openInChatGPT: 'Abrir no ChatGPT',
       openInChatGPTCaption: 'Pergunte ao ChatGPT sobre esta página',
       openInClaude: 'Abrir no Claude',
-      openInClaudeCaption: 'Pergunte ao Claude sobre esta página'
+      openInClaudeCaption: 'Pergunte ao Claude sobre esta página',
+      mcpServer: 'Servidor MCP',
+      mcpServerCaption: 'Conecte assistentes de IA via MCP'
     }
   }
 }

package/src/index.js

@@ -40,6 +40,9 @@
  * @param {string} config.github.editBaseUrl - Base URL for "Edit on GitHub" links
  * @param {Array} config.languages - Available languages [{image, label, value}]
  * @param {string} [config.defaultLanguage='en-US'] - Default language code
+ * @param {Object} [config.mcp] - MCP (Model Context Protocol) server settings
+ * @param {string} config.mcp.serverName - Server name for MCP identification (e.g. 'my-docs')
+ * @param {string} config.mcp.toolSuffix - Suffix for tool names (e.g. 'my_docs' → search_my_docs)
  * @returns {Object} Resolved Docsector configuration
  */
 export function createDocsector (config = {}) {
@@ -77,7 +80,9 @@ export function createDocsector (config = {}) {
       }
     ],
 
-    defaultLanguage: config.defaultLanguage || 'en-US'
+    defaultLanguage: config.defaultLanguage || 'en-US',
+
+    mcp: config.mcp || null
   }
 }
 

package/src/mcp/server.js

@@ -0,0 +1,280 @@
+/**
+ * Docsector MCP Server — Cloudflare Pages Function
+ *
+ * Auto-generated by docsector build. Do not edit manually.
+ *
+ * This implements the MCP (Model Context Protocol) Streamable HTTP transport,
+ * exposing documentation content as tools for AI assistants.
+ *
+ * Placeholders replaced at build time:
+ *   __MCP_SERVER_NAME__    → config.mcp.serverName
+ *   __MCP_SERVER_VERSION__ → config.branding.version
+ *   __MCP_TOOL_SUFFIX__    → config.mcp.toolSuffix
+ *   __MCP_SITE_URL__       → config.siteUrl
+ */
+
+const SERVER_NAME = '__MCP_SERVER_NAME__'
+const SERVER_VERSION = '__MCP_SERVER_VERSION__'
+const TOOL_SUFFIX = '__MCP_TOOL_SUFFIX__'
+const SITE_URL = '__MCP_SITE_URL__'
+
+const PROTOCOL_VERSION = '2025-03-26'
+
+const CORS_HEADERS = {
+  'Access-Control-Allow-Origin': '*',
+  'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
+  'Access-Control-Allow-Headers': 'Content-Type, Accept, Mcp-Session-Id',
+  'Access-Control-Expose-Headers': 'Mcp-Session-Id'
+}
+
+function jsonResponse (body, status = 200) {
+  return new Response(JSON.stringify(body), {
+    status,
+    headers: { 'Content-Type': 'application/json', ...CORS_HEADERS }
+  })
+}
+
+function jsonRpcResponse (id, result) {
+  return jsonResponse({ jsonrpc: '2.0', id, result })
+}
+
+function jsonRpcError (id, code, message) {
+  return jsonResponse({ jsonrpc: '2.0', id, error: { code, message } })
+}
+
+// --- Tool definitions ---
+
+const TOOLS = [
+  {
+    name: `search_${TOOL_SUFFIX}`,
+    description: `Search the ${SERVER_NAME} documentation. Returns matching pages with titles and URLs. Use this to find relevant documentation pages by keyword.`,
+    inputSchema: {
+      type: 'object',
+      properties: {
+        query: {
+          type: 'string',
+          description: 'Search term or phrase to find in the documentation'
+        }
+      },
+      required: ['query']
+    }
+  },
+  {
+    name: `get_page_${TOOL_SUFFIX}`,
+    description: `Get the full Markdown content of a specific ${SERVER_NAME} documentation page. Use the path returned by search_${TOOL_SUFFIX}, or provide a known documentation path.`,
+    inputSchema: {
+      type: 'object',
+      properties: {
+        path: {
+          type: 'string',
+          description: 'Page path (e.g. "manual/CLI/Terminal/Output/overview"). Do not include leading slash or .md extension.'
+        }
+      },
+      required: ['path']
+    }
+  }
+]
+
+// --- Page index cache (per-isolate) ---
+
+let cachedPages = null
+
+async function getPages (env) {
+  if (cachedPages) return cachedPages
+
+  const url = new URL('/mcp-pages.json', SITE_URL || 'http://localhost')
+  const res = await env.ASSETS.fetch(url.toString())
+
+  if (!res.ok) return []
+
+  cachedPages = await res.json()
+  return cachedPages
+}
+
+// --- Tool handlers ---
+
+async function handleSearch (args, env) {
+  const query = (args.query || '').toLowerCase().trim()
+  if (!query) {
+    return { content: [{ type: 'text', text: 'Please provide a search query.' }], isError: true }
+  }
+
+  const pages = await getPages(env)
+  const terms = query.split(/\s+/)
+
+  // Score pages by title match
+  const results = []
+  for (const page of pages) {
+    const title = (page.title || '').toLowerCase()
+    const path = (page.path || '').toLowerCase()
+
+    let score = 0
+    for (const term of terms) {
+      if (title.includes(term)) score += 2
+      if (path.includes(term)) score += 1
+    }
+
+    if (score > 0) {
+      results.push({ ...page, score })
+    }
+  }
+
+  results.sort((a, b) => b.score - a.score)
+  const top = results.slice(0, 15)
+
+  if (top.length === 0) {
+    return {
+      content: [{ type: 'text', text: `No documentation pages found for "${args.query}".` }]
+    }
+  }
+
+  const siteBase = (SITE_URL || '').replace(/\/+$/, '')
+  const lines = top.map(r => {
+    const url = siteBase ? `${siteBase}/${r.path}` : r.path
+    return `- **${r.title}** — [${r.path}](${url})`
+  })
+
+  return {
+    content: [{
+      type: 'text',
+      text: `Found ${results.length} result(s) for "${args.query}":\n\n${lines.join('\n')}\n\nUse get_page_${TOOL_SUFFIX} with the path to read the full content.`
+    }]
+  }
+}
+
+async function handleGetPage (args, env) {
+  let path = (args.path || '').replace(/^\/+/, '').replace(/\/+$/, '').replace(/\.md$/, '')
+  if (!path) {
+    return { content: [{ type: 'text', text: 'Please provide a page path.' }], isError: true }
+  }
+
+  const siteBase = SITE_URL || 'http://localhost'
+
+  // Try the path as-is, then with /overview appended
+  const attempts = [`/${path}.md`]
+  if (!path.endsWith('/overview') && !path.endsWith('/showcase') && !path.endsWith('/vs')) {
+    attempts.push(`/${path}/overview.md`)
+  }
+
+  for (const mdPath of attempts) {
+    const url = new URL(mdPath, siteBase)
+    const res = await env.ASSETS.fetch(url.toString())
+
+    if (res.ok) {
+      const text = await res.text()
+      const siteUrl = siteBase.replace(/\/+$/, '')
+      const pagePath = mdPath.replace(/^\//, '').replace(/\.md$/, '')
+
+      return {
+        content: [{
+          type: 'text',
+          text: `# ${pagePath}\n\nSource: ${siteUrl}/${pagePath}\n\n---\n\n${text}`
+        }]
+      }
+    }
+  }
+
+  return {
+    content: [{
+      type: 'text',
+      text: `Page not found: "${path}". Use search_${TOOL_SUFFIX} to find available pages.`
+    }],
+    isError: true
+  }
+}
+
+// --- MCP JSON-RPC dispatcher ---
+
+async function handleJsonRpc (body, env) {
+  const { jsonrpc, id, method, params } = body
+
+  if (jsonrpc !== '2.0') {
+    return jsonRpcError(id ?? null, -32600, 'Invalid JSON-RPC version')
+  }
+
+  switch (method) {
+    case 'initialize':
+      return jsonRpcResponse(id, {
+        protocolVersion: PROTOCOL_VERSION,
+        capabilities: {
+          tools: { listChanged: false }
+        },
+        serverInfo: {
+          name: SERVER_NAME,
+          version: SERVER_VERSION
+        }
+      })
+
+    case 'notifications/initialized':
+      // Client acknowledgement — no response needed for notifications
+      return new Response(null, { status: 204, headers: CORS_HEADERS })
+
+    case 'tools/list':
+      return jsonRpcResponse(id, { tools: TOOLS })
+
+    case 'tools/call': {
+      const toolName = params?.name
+      const args = params?.arguments || {}
+
+      if (toolName === `search_${TOOL_SUFFIX}`) {
+        const result = await handleSearch(args, env)
+        return jsonRpcResponse(id, result)
+      }
+
+      if (toolName === `get_page_${TOOL_SUFFIX}`) {
+        const result = await handleGetPage(args, env)
+        return jsonRpcResponse(id, result)
+      }
+
+      return jsonRpcError(id, -32602, `Unknown tool: "${toolName}"`)
+    }
+
+    default:
+      return jsonRpcError(id, -32601, `Method not found: "${method}"`)
+  }
+}
+
+// --- Cloudflare Pages Function handlers ---
+
+export async function onRequestGet (context) {
+  const siteBase = (SITE_URL || '').replace(/\/+$/, '')
+
+  return jsonResponse({
+    name: SERVER_NAME,
+    version: SERVER_VERSION,
+    protocolVersion: PROTOCOL_VERSION,
+    capabilities: { tools: TOOLS.map(t => t.name) },
+    documentation: siteBase || undefined,
+    usage: {
+      claude_desktop: {
+        [SERVER_NAME]: { type: 'url', url: `${siteBase}/mcp` }
+      },
+      vscode: {
+        [SERVER_NAME]: { type: 'http', url: `${siteBase}/mcp` }
+      },
+      curl: `curl -X POST ${siteBase}/mcp -H "Content-Type: application/json" -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'`
+    }
+  })
+}
+
+export async function onRequestPost (context) {
+  const { request, env } = context
+
+  const contentType = request.headers.get('content-type') || ''
+  if (!contentType.includes('application/json')) {
+    return jsonRpcError(null, -32700, 'Content-Type must be application/json')
+  }
+
+  let body
+  try {
+    body = await request.json()
+  } catch {
+    return jsonRpcError(null, -32700, 'Parse error: invalid JSON')
+  }
+
+  return handleJsonRpc(body, env)
+}
+
+export async function onRequestOptions () {
+  return new Response(null, { status: 204, headers: CORS_HEADERS })
+}

package/src/quasar.factory.js

@@ -481,6 +481,92 @@ function createMarkdownBuildPlugin (projectRoot) {
         writeFileSync(headersPath, headersRule)
       }
       console.log(`\x1b[36m[docsector]\x1b[0m Added _headers rule for .md files`)
+
+      // Generate MCP server if configured
+      if (config.mcp) {
+        const mcpConfig = config.mcp
+        const mcpServerName = mcpConfig.serverName || 'docs'
+        const mcpToolSuffix = mcpConfig.toolSuffix || 'docs'
+        const mcpVersion = config.branding?.version || '1.0.0'
+
+        // Collect page index for MCP
+        const mcpPages = []
+        for (const [pagePath, page] of Object.entries(pages)) {
+          if (page.config === null) continue
+          if (page.config.status === 'empty') continue
+
+          const type = page.config.type ?? 'manual'
+          const defaultTitle = page.data?.['*']?.title
+            || page.data?.[defaultLang]?.title
+            || page.data?.['en-US']?.title
+            || pagePath.split('/').pop()
+            || pagePath
+
+          const subpageList = ['overview']
+          if (page.config.subpages?.showcase) subpageList.push('showcase')
+          if (page.config.subpages?.vs) subpageList.push('vs')
+
+          for (const subpage of subpageList) {
+            const srcFile = resolve(pagesDir, `${type}${pagePath}.${subpage}.${defaultLang}.md`)
+            if (!existsSync(srcFile)) continue
+
+            mcpPages.push({
+              path: `${type}${pagePath}/${subpage}`,
+              title: defaultTitle,
+              type,
+              subpage
+            })
+          }
+        }
+
+        // Write mcp-pages.json
+        writeFileSync(
+          resolve(distDir, 'mcp-pages.json'),
+          JSON.stringify(mcpPages, null, 2)
+        )
+        console.log(`\x1b[36m[docsector]\x1b[0m Generated mcp-pages.json (${mcpPages.length} pages)`)
+
+        // Read server template from package, replace placeholders, write to project root functions/
+        // Cloudflare Pages expects functions/ in the project root, not inside dist/spa/
+        const packageRoot = getPackageRoot(projectRoot)
+        const templatePath = resolve(packageRoot, 'src', 'mcp', 'server.js')
+        if (existsSync(templatePath)) {
+          let serverCode = readFileSync(templatePath, 'utf-8')
+          serverCode = serverCode
+            .replaceAll('__MCP_SERVER_NAME__', mcpServerName)
+            .replaceAll('__MCP_SERVER_VERSION__', mcpVersion)
+            .replaceAll('__MCP_TOOL_SUFFIX__', mcpToolSuffix)
+            .replaceAll('__MCP_SITE_URL__', siteUrl || '')
+
+          const functionsDir = resolve(projectRoot, 'functions')
+          mkdirSync(functionsDir, { recursive: true })
+          writeFileSync(resolve(functionsDir, 'mcp.js'), serverCode)
+          console.log(`\x1b[36m[docsector]\x1b[0m Generated MCP server at functions/mcp.js`)
+        }
+
+        // Add CORS headers for /mcp to _headers
+        const mcpHeaders = '/mcp\n  Access-Control-Allow-Origin: *\n  Access-Control-Allow-Methods: GET, POST, OPTIONS\n  Access-Control-Allow-Headers: Content-Type, Accept, Mcp-Session-Id\n  Access-Control-Expose-Headers: Mcp-Session-Id\n'
+        const currentHeaders = readFileSync(headersPath, 'utf-8')
+        if (!currentHeaders.includes('/mcp')) {
+          writeFileSync(headersPath, currentHeaders.trimEnd() + '\n\n' + mcpHeaders)
+        }
+
+        // Generate or merge _routes.json for Cloudflare Pages
+        const routesPath = resolve(distDir, '_routes.json')
+        let routes = { version: 1, include: [], exclude: [] }
+        if (existsSync(routesPath)) {
+          try {
+            routes = JSON.parse(readFileSync(routesPath, 'utf-8'))
+          } catch {
+            // empty
+          }
+        }
+        if (!routes.include.includes('/mcp')) {
+          routes.include.push('/mcp')
+        }
+        writeFileSync(routesPath, JSON.stringify(routes, null, 2))
+        console.log(`\x1b[36m[docsector]\x1b[0m Added /mcp to _routes.json`)
+      }
     }
   }
 }