feat(docs): adds plugin to generate MCP server artifacts and CloudFlare MCP worker script (#1274)

Author: fassko

cloudflare-mcp/src/index.js

@@ -0,0 +1,37 @@
+import { createCloudflareHandler } from "docusaurus-plugin-mcp-server/adapters";
+import docs from "../../build/mcp/docs.json";
+import searchIndexData from "../../build/mcp/search-index.json";
+
+let cachedHandler = null;
+let cachedBaseUrl = null;
+
+export default {
+  async fetch(request, env) {
+    const url = new URL(request.url);
+
+    if (!url.pathname.startsWith("/mcp")) {
+      return new Response("Not found", { status: 404 });
+    }
+
+    const baseUrl = env?.DOCS_BASE_URL ?? "https://dev.flare.network/";
+
+    if (!cachedHandler || cachedBaseUrl !== baseUrl) {
+      cachedBaseUrl = baseUrl;
+
+      cachedHandler = createCloudflareHandler({
+        docs,
+        searchIndexData,
+        name: env?.MCP_SERVER_NAME ?? "flare-devhub",
+        version: env?.MCP_SERVER_VERSION ?? "1.0.0",
+        baseUrl,
+      });
+    }
+
+    const newRequest = new Request(
+      request.url.replace("/mcp", "") || "/",
+      request,
+    );
+
+    return cachedHandler(newRequest);
+  },
+};

cloudflare-mcp/wrangler.toml

@@ -0,0 +1,15 @@
+name = "flare-devhub-mcp"
+main = "src/index.ts"
+compatibility_date = "2026-01-01"
+compatibility_flags = ["nodejs_compat"]
+preview_urls = false
+
+routes = [
+  { pattern = "dev.flare.network/mcp*", zone_name = "flare.network" }
+]
+
+[vars]
+DOCS_BASE_URL = "https://dev.flare.network/"
+MCP_SERVER_NAME = "flare-devhub"
+MCP_SERVER_VERSION = "1.0.0"
+

docusaurus.config.ts

@@ -359,6 +359,15 @@ const config: Config = {
         ],
       },
     ],
+    [
+      "docusaurus-plugin-mcp-server",
+      {
+        server: {
+          name: "flare-devhub",
+          version: "1.0.0",
+        },
+      },
+    ],
   ],
   scripts: [
     // Defer cookie script loading until after page load