docusaurus-plugin-mcp-server 0.10.0 → 0.10.2

package/README.md

@@ -43,10 +43,13 @@ Choose your deployment platform:
 Create `api/mcp.js`:
 
 ```javascript
-const { createVercelHandler } = require('docusaurus-plugin-mcp-server/adapters');
-const path = require('path');
+import { createVercelHandler } from 'docusaurus-plugin-mcp-server/adapters';
+import path from 'path';
+import { fileURLToPath } from 'url';
 
-module.exports = createVercelHandler({
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+
+export default createVercelHandler({
   docsPath: path.join(__dirname, '../build/mcp/docs.json'),
   indexPath: path.join(__dirname, '../build/mcp/search-index.json'),
   name: 'my-docs',
@@ -77,10 +80,13 @@ Add to `vercel.json`:
 Create `netlify/functions/mcp.js`:
 
 ```javascript
-const { createNetlifyHandler } = require('docusaurus-plugin-mcp-server/adapters');
-const path = require('path');
+import { createNetlifyHandler } from 'docusaurus-plugin-mcp-server/adapters';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
 
-exports.handler = createNetlifyHandler({
+export const handler = createNetlifyHandler({
   docsPath: path.join(__dirname, '../../build/mcp/docs.json'),
   indexPath: path.join(__dirname, '../../build/mcp/search-index.json'),
   name: 'my-docs',
@@ -170,7 +176,11 @@ function NavbarItems() {
 }
 ```
 
-The button shows a dropdown with copy-to-clipboard configurations for all supported MCP clients (Claude Code, Cursor, VS Code, Windsurf, Claude Desktop).
+The button shows a dropdown with copy-to-clipboard configurations for all supported MCP clients.
+
+| Light Mode | Dark Mode |
+|:----------:|:---------:|
+| ![MCP Install Button - Light Mode](./img/mcp-button-light.png) | ![MCP Install Button - Dark Mode](./img/mcp-button-dark.png) |
 
 **Props:**
 

package/dist/adapters-entry.d.ts

@@ -8,10 +8,13 @@ import { M as McpServerConfig, P as ProcessedDoc, a as McpServerFileConfig } fro
  *
  * @example
  * // api/mcp.js
- * const { createVercelHandler } = require('docusaurus-plugin-mcp-server/adapters');
- * const path = require('path');
+ * import { createVercelHandler } from 'docusaurus-plugin-mcp-server/adapters';
+ * import path from 'path';
+ * import { fileURLToPath } from 'url';
  *
- * module.exports = createVercelHandler({
+ * const __dirname = path.dirname(fileURLToPath(import.meta.url));
+ *
+ * export default createVercelHandler({
  *   docsPath: path.join(__dirname, '../build/mcp/docs.json'),
  *   indexPath: path.join(__dirname, '../build/mcp/search-index.json'),
  *   name: 'my-docs',
@@ -48,10 +51,13 @@ declare function createVercelHandler(config: McpServerConfig): (req: VercelReque
  *
  * @example
  * // netlify/functions/mcp.js
- * const { createNetlifyHandler } = require('docusaurus-plugin-mcp-server/adapters');
- * const path = require('path');
+ * import { createNetlifyHandler } from 'docusaurus-plugin-mcp-server/adapters';
+ * import path from 'path';
+ * import { fileURLToPath } from 'url';
+ *
+ * const __dirname = path.dirname(fileURLToPath(import.meta.url));
  *
- * exports.handler = createNetlifyHandler({
+ * export const handler = createNetlifyHandler({
  *   docsPath: path.join(__dirname, '../../build/mcp/docs.json'),
  *   indexPath: path.join(__dirname, '../../build/mcp/search-index.json'),
  *   name: 'my-docs',

package/dist/adapters-entry.js

@@ -1,17 +1,10 @@
-'use strict';
-
-var mcp_js = require('@modelcontextprotocol/sdk/server/mcp.js');
-var streamableHttp_js = require('@modelcontextprotocol/sdk/server/streamableHttp.js');
-var webStandardStreamableHttp_js = require('@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js');
-var FlexSearch = require('flexsearch');
-var fs = require('fs-extra');
-var zod = require('zod');
-var http = require('http');
-
-function _interopDefault (e) { return e && e.__esModule ? e : { default: e }; }
-
-var FlexSearch__default = /*#__PURE__*/_interopDefault(FlexSearch);
-var fs__default = /*#__PURE__*/_interopDefault(fs);
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/streamableHttp.js';
+import { WebStandardStreamableHTTPServerTransport } from '@modelcontextprotocol/sdk/server/webStandardStreamableHttp.js';
+import FlexSearch from 'flexsearch';
+import fs from 'fs-extra';
+import { z } from 'zod';
+import { createServer } from 'http';
 
 // src/mcp/server.ts
 var FIELD_WEIGHTS = {
@@ -25,7 +18,7 @@ function englishStemmer(word) {
   return word.replace(/ing$/, "").replace(/tion$/, "t").replace(/sion$/, "s").replace(/([^aeiou])ed$/, "$1").replace(/([^aeiou])es$/, "$1").replace(/ly$/, "").replace(/ment$/, "").replace(/ness$/, "").replace(/ies$/, "y").replace(/([^s])s$/, "$1");
 }
 function createSearchIndex() {
-  return new FlexSearch__default.default.Document({
+  return new FlexSearch.Document({
     // Use 'full' tokenization for substring matching
     // This allows "auth" to match "authentication"
     tokenize: "full",
@@ -162,13 +155,13 @@ var FlexSearchProvider = class {
       return;
     }
     if (initData.docsPath && initData.indexPath) {
-      if (await fs__default.default.pathExists(initData.docsPath)) {
-        this.docs = await fs__default.default.readJson(initData.docsPath);
+      if (await fs.pathExists(initData.docsPath)) {
+        this.docs = await fs.readJson(initData.docsPath);
       } else {
         throw new Error(`[FlexSearch] Docs file not found: ${initData.docsPath}`);
       }
-      if (await fs__default.default.pathExists(initData.indexPath)) {
-        const indexData = await fs__default.default.readJson(initData.indexPath);
+      if (await fs.pathExists(initData.indexPath)) {
+        const indexData = await fs.readJson(initData.indexPath);
         this.searchIndex = await importSearchIndex(indexData);
       } else {
         throw new Error(`[FlexSearch] Search index not found: ${initData.indexPath}`);
@@ -260,8 +253,8 @@ function isSearchProvider(obj) {
   return typeof provider.name === "string" && typeof provider.initialize === "function" && typeof provider.isReady === "function" && typeof provider.search === "function";
 }
 var docsSearchInputSchema = {
-  query: zod.z.string().min(1).describe("The search query string"),
-  limit: zod.z.number().int().min(1).max(20).optional().default(5).describe("Maximum number of results to return (1-20, default: 5)")
+  query: z.string().min(1).describe("The search query string"),
+  limit: z.number().int().min(1).max(20).optional().default(5).describe("Maximum number of results to return (1-20, default: 5)")
 };
 var docsSearchTool = {
   name: "docs_search",
@@ -289,7 +282,7 @@ function formatSearchResults(results) {
   return lines.join("\n");
 }
 var docsFetchInputSchema = {
-  url: zod.z.string().url().describe(
+  url: z.string().url().describe(
     'The full URL of the page to fetch (e.g., "https://docs.example.com/docs/getting-started")'
   )
 };
@@ -340,7 +333,7 @@ var McpDocsServer = class {
   initialized = false;
   constructor(config) {
     this.config = config;
-    this.mcpServer = new mcp_js.McpServer(
+    this.mcpServer = new McpServer(
       {
         name: config.name,
         version: config.version ?? "1.0.0"
@@ -475,7 +468,7 @@ var McpDocsServer = class {
    */
   async handleHttpRequest(req, res, parsedBody) {
     await this.initialize();
-    const transport = new streamableHttp_js.StreamableHTTPServerTransport({
+    const transport = new StreamableHTTPServerTransport({
       sessionIdGenerator: void 0,
       // Stateless mode - no session tracking
       enableJsonResponse: true
@@ -499,7 +492,7 @@ var McpDocsServer = class {
    */
   async handleWebRequest(request) {
     await this.initialize();
-    const transport = new webStandardStreamableHttp_js.WebStandardStreamableHTTPServerTransport({
+    const transport = new WebStandardStreamableHTTPServerTransport({
       sessionIdGenerator: void 0,
       // Stateless mode
       enableJsonResponse: true
@@ -809,12 +802,14 @@ function generateVercelFiles(name, baseUrl) {
  * Deploy to Vercel and this will be available at /api/mcp
  */
 
-const { createVercelHandler } = require('docusaurus-plugin-mcp-server/adapters');
-const path = require('path');
+import { createVercelHandler } from 'docusaurus-plugin-mcp-server/adapters';
+import path from 'path';
+import { fileURLToPath } from 'url';
 
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const projectRoot = path.join(__dirname, '..');
 
-module.exports = createVercelHandler({
+export default createVercelHandler({
   docsPath: path.join(projectRoot, 'build/mcp/docs.json'),
   indexPath: path.join(projectRoot, 'build/mcp/search-index.json'),
   name: '${name}',
@@ -853,12 +848,14 @@ function generateNetlifyFiles(name, baseUrl) {
  * Deploy to Netlify and this will be available at /.netlify/functions/mcp
  */
 
-const { createNetlifyHandler } = require('docusaurus-plugin-mcp-server/adapters');
-const path = require('path');
+import { createNetlifyHandler } from 'docusaurus-plugin-mcp-server/adapters';
+import path from 'path';
+import { fileURLToPath } from 'url';
 
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const projectRoot = path.join(__dirname, '../..');
 
-exports.handler = createNetlifyHandler({
+export const handler = createNetlifyHandler({
   docsPath: path.join(projectRoot, 'build/mcp/docs.json'),
   indexPath: path.join(projectRoot, 'build/mcp/search-index.json'),
   name: '${name}',
@@ -1015,7 +1012,7 @@ function createNodeHandler(options) {
 }
 function createNodeServer(options) {
   const handler = createNodeHandler(options);
-  return http.createServer(handler);
+  return createServer(handler);
 }
 async function parseRequestBody(req) {
   return new Promise((resolve, reject) => {
@@ -1034,11 +1031,6 @@ async function parseRequestBody(req) {
   });
 }
 
-exports.createCloudflareHandler = createCloudflareHandler;
-exports.createNetlifyHandler = createNetlifyHandler;
-exports.createNodeHandler = createNodeHandler;
-exports.createNodeServer = createNodeServer;
-exports.createVercelHandler = createVercelHandler;
-exports.generateAdapterFiles = generateAdapterFiles;
+export { createCloudflareHandler, createNetlifyHandler, createNodeHandler, createNodeServer, createVercelHandler, generateAdapterFiles };
 //# sourceMappingURL=adapters-entry.js.map
 //# sourceMappingURL=adapters-entry.js.map