pmndrs
diff --git a/‎.changeset/neat-lions-bet.md‎
Lines changed: 5 additions & 0 deletions b/‎.changeset/neat-lions-bet.md‎
Lines changed: 5 additions & 0 deletions
diff --git a/‎.gitignore‎
Lines changed: 1 addition & 0 deletions b/‎.gitignore‎
Lines changed: 1 addition & 0 deletions
diff --git a/‎docs/getting-started/introduction.mdx‎
Lines changed: 12 additions & 4 deletions b/‎docs/getting-started/introduction.mdx‎
Lines changed: 12 additions & 4 deletions
diff --git a/‎next-build.sh‎
Lines changed: 35 additions & 0 deletions b/‎next-build.sh‎
Lines changed: 35 additions & 0 deletions
diff --git a/‎package.json‎
Lines changed: 8 additions & 2 deletions b/‎package.json‎
Lines changed: 8 additions & 2 deletions
diff --git a/‎playwright.config.ts‎
Lines changed: 1 addition & 0 deletions b/‎playwright.config.ts‎
Lines changed: 1 addition & 0 deletions
@@ -0,0 +1,5 @@
+---
+'@pmndrs/docs': minor
+---
+
+mcp support
@@ -17,6 +17,7 @@ node_modules/
 .next/
 .DS_Store
 .secrets
+tmp/api-backup
 
 build/
 dist/
 
@@ -103,7 +103,9 @@ We implement [m3 design system](https://m3.material.io/styles/color/system/overv
 
 </details>
 
-## dev
+## Usage
+
+### dev
 
 ```sh
 $ (
@@ -118,7 +120,7 @@ $ (
   export NEXT_PUBLIC_LIBNAME_DOTSUFFIX_HREF="https://docs.pmnd.rs"
   export BASE_PATH=
   export DIST_DIR=
-  export OUTPUT=export
+  export OUTPUT=
   export HOME_REDIRECT=
   export MDX_BASEURL=http://localhost:$_PORT
   export SOURCECODE_BASEURL="vscode://file$(pwd)"
@@ -152,7 +154,7 @@ Then go to: http://localhost:3000
 > [!TIP]
 > If `HOME_REDIRECT=` empty, `/` will not redirect, and instead displays an index of libraries.
 
-## build
+### build
 
 ```sh
 $ (
@@ -202,7 +204,7 @@ $ (
 
 http://localhost:3000
 
-## Docker
+### Docker
 
 ```sh
 $ docker build -t pmndrs-docs .
@@ -294,4 +296,10 @@ These URLs are linked in the HTML header as:
 ```html
 <link rel="alternate" type="text/plain" href="/llms.txt" />
 <link rel="alternate" type="text/plain" href="/llms-full.txt" />
+```
+
+## MCP Server
+
+```sh
+$ npx -y @modelcontextprotocol/inspector
 ```
@@ -0,0 +1,35 @@
+#!/bin/sh
+#
+# Next.js build wrapper for static export compatibility
+#
+# When building in export mode (OUTPUT=export), Next.js cannot handle Route Handlers
+# (route.ts files) as they require server runtime. This script temporarily moves the
+# /api directory during the build, then restores it afterward to preserve the source.
+#
+# Usage:
+#   OUTPUT=export npm run build  # Static export (GitHub Pages)
+#   npm run build                # Server build (Vercel)
+
+# Check if we're building in export mode
+if [ "$OUTPUT" = "export" ]; then
+  IS_EXPORT=true
+else
+  IS_EXPORT=false
+fi
+
+# Move API directory if building for export
+if [ "$IS_EXPORT" = "true" ]; then
+  mkdir -p tmp
+  mv src/app/api tmp/api-backup
+fi
+
+# Run Next.js build
+next build
+STATUS=$?
+
+# Restore API directory if it was moved
+if [ "$IS_EXPORT" = "true" ]; then
+  mv tmp/api-backup src/app/api
+fi
+
+exit $STATUS
@@ -32,6 +32,7 @@
     "husky": "^9.1.7",
     "lint-staged": "^15.2.10",
     "minimist": "^1.2.8",
+    "msw": "^2.12.8",
     "postcss": "^8.4.45",
     "prettier": "^3.3.3",
     "prettier-plugin-organize-imports": "^4.0.0",
@@ -51,11 +52,13 @@
     "@codesandbox/sandpack-react": "^2.20.0",
     "@fontsource/inconsolata": "^5.2.8",
     "@fontsource/inter": "^5.2.8",
+    "@modelcontextprotocol/sdk": "^1.25.2",
     "@octokit/core": "^6.1.2",
     "@radix-ui/react-collapsible": "^1.1.0",
     "@radix-ui/react-dialog": "^1.1.1",
     "@radix-ui/react-visually-hidden": "^1.2.4",
     "@tailwindcss/aspect-ratio": "^0.4.2",
+    "cheerio": "^1.0.0",
     "class-variance-authority": "^0.7.1",
     "clsx": "^2.1.1",
     "cmdk": "^1.1.1",
@@ -64,6 +67,7 @@
     "lodash-es": "^4.17.21",
     "lucide-react": "^0.563.0",
     "match-sorter": "^6.3.4",
+    "mcp-handler": "^1.0.7",
     "mermaid": "^11.12.2",
     "next": "^16.1.3",
     "next-mdx-remote": "^5.0.0",
@@ -77,12 +81,14 @@
     "remark-gfm": "^4.0.1",
     "sanitize-html": "^2.17.0",
     "tailwind-merge": "^3.4.0",
-    "unist-util-visit": "^5.0.0"
+    "unist-util-visit": "^5.0.0",
+    "xmlbuilder2": "^3.1.1",
+    "zod": "^3.24.1"
   },
   "scripts": {
     "dev": "NODE_OPTIONS='--inspect' next",
     "start": "next start",
-    "build": "next build",
+    "build": "./next-build.sh",
     "format": "prettier -w src/",
     "lint": "eslint src/**/*.{ts,tsx} && prettier . --check",
     "prepare": "husky && (test -f scripts/copy-fonts.sh && sh scripts/copy-fonts.sh || true)",
 
@@ -5,6 +5,7 @@ import { defineConfig, devices } from '@playwright/test'
  */
 export default defineConfig({
   testDir: './src/app',
+  testIgnore: '**/route.test.ts',
   use: {
     baseURL: 'http://localhost:3000',
   },
-Original file line number
+Diff line change
@@ @@ -0,0 +1,5 @@ @@
 +---
 +'@pmndrs/docs': minor
 +---
++
 +mcp support