docusaurus-plugin-mcp-server 0.8.0 → 0.10.0

package/README.md

@@ -178,17 +178,18 @@ The button shows a dropdown with copy-to-clipboard configurations for all suppor
 |------|------|---------|-------------|
 | `serverUrl` | `string` | required | Your MCP server endpoint URL |
 | `serverName` | `string` | required | Name for the MCP server |
-| `label` | `string` | `"Install MCP"` | Button label |
+| `label` | `string` | (none) | Button label. If omitted, shows only the MCP icon |
+| `headerText` | `string` | `"Choose your AI tool:"` | Text shown at the top of the dropdown |
 | `className` | `string` | `""` | Optional CSS class |
 | `clients` | `ClientId[]` | All HTTP-capable | Which clients to show |
 
 ## MCP Tools
 
-The server exposes three tools for AI agents:
+The server exposes two tools for AI agents:
 
 ### `docs_search`
 
-Search across documentation with relevance ranking.
+Search across documentation with relevance ranking. Returns matching documents with URLs, snippets, and relevance scores.
 
 ```json
 {
@@ -205,41 +206,33 @@ Search across documentation with relevance ranking.
 | `query` | `string` | required | Search query |
 | `limit` | `number` | `5` | Max results (1-20) |
 
-### `docs_get_page`
+**Response includes:**
+- Full URL for each result (use with `docs_fetch`)
+- Title and relevance score
+- Snippet of matching content
+- Matching headings
 
-Retrieve full page content as markdown.
+### `docs_fetch`
 
-```json
-{
-  "name": "docs_get_page",
-  "arguments": {
-    "route": "/docs/authentication"
-  }
-}
-```
-
-| Parameter | Type | Description |
-|-----------|------|-------------|
-| `route` | `string` | Page route path |
-
-### `docs_get_section`
-
-Retrieve a specific section by heading ID.
+Retrieve full page content as markdown. Use this after searching to get the complete content of a specific page.
 
 ```json
 {
-  "name": "docs_get_section",
+  "name": "docs_fetch",
   "arguments": {
-    "route": "/docs/authentication",
-    "headingId": "oauth-configuration"
+    "url": "https://docs.example.com/docs/authentication"
   }
 }
 ```
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
-| `route` | `string` | Page route path |
-| `headingId` | `string` | Heading ID to extract |
+| `url` | `string` | Full URL of the page (from search results) |
+
+**Response includes:**
+- Page title and description
+- Table of contents with anchor links
+- Full markdown content
 
 ## Plugin Options
 
@@ -398,8 +391,8 @@ The plugin operates in two phases:
 
 - **Full-text Search** - FlexSearch-powered search with relevance ranking
 - **Page Retrieval** - Get complete page content as clean markdown
-- **Section Extraction** - Retrieve specific sections by heading ID
 - **Platform Adapters** - Pre-built adapters for Vercel, Netlify, and Cloudflare Workers
+- **CORS Support** - All adapters include CORS headers for browser-based clients
 - **Build-time Processing** - Extracts content from rendered HTML, capturing React component output
 - **Zero Runtime Docusaurus Dependency** - The MCP server runs independently
 
@@ -424,19 +417,23 @@ const server = new McpDocsServer({
 });
 
 http.createServer(async (req, res) => {
+  if (req.method === 'OPTIONS') {
+    res.writeHead(204, {
+      'Access-Control-Allow-Origin': '*',
+      'Access-Control-Allow-Methods': 'GET, POST, OPTIONS',
+      'Access-Control-Allow-Headers': 'Content-Type',
+    });
+    res.end();
+    return;
+  }
+
   if (req.method !== 'POST') {
     res.writeHead(405);
     res.end();
     return;
   }
 
-  let body = '';
-  req.on('data', (chunk) => (body += chunk));
-  req.on('end', async () => {
-    const response = await server.handleRequest(JSON.parse(body));
-    res.writeHead(200, { 'Content-Type': 'application/json' });
-    res.end(JSON.stringify(response));
-  });
+  await server.handleHttpRequest(req, res);
 }).listen(3456, () => {
   console.log('MCP server at http://localhost:3456');
 });
@@ -461,8 +458,7 @@ import {
 
   // Tool definitions
   docsSearchTool,
-  docsGetPageTool,
-  docsGetSectionTool,
+  docsFetchTool,
 
   // Utilities
   htmlToMarkdown,
@@ -470,6 +466,12 @@ import {
   extractHeadingsFromMarkdown,
   buildSearchIndex,
 
+  // Provider types (for custom implementations)
+  loadIndexer,
+  loadSearchProvider,
+  FlexSearchIndexer,
+  FlexSearchProvider,
+
   // Default options
   DEFAULT_OPTIONS,
 } from 'docusaurus-plugin-mcp-server';

package/dist/adapters-entry.d.mts

@@ -1,5 +1,5 @@
-import { IncomingMessage, ServerResponse } from 'node:http';
-import { M as McpServerConfig, P as ProcessedDoc } from './index-4g0ZZK3z.mjs';
+import { IncomingMessage, ServerResponse, Server } from 'node:http';
+import { M as McpServerConfig, P as ProcessedDoc, a as McpServerFileConfig } from './index-j-CdaS6k.mjs';
 
 /**
  * Vercel adapter for MCP server
@@ -177,4 +177,49 @@ interface GeneratedFile {
  */
 declare function generateAdapterFiles(options: GeneratorOptions): GeneratedFile[];
 
-export { type CloudflareAdapterConfig, type GeneratedFile, type GeneratorOptions, type NetlifyContext, type NetlifyEvent, type Platform, type VercelRequest, type VercelResponse, createCloudflareHandler, createNetlifyHandler, createVercelHandler, generateAdapterFiles };
+/**
+ * Node.js adapter for MCP server
+ *
+ * Creates a standalone HTTP server for local development and testing.
+ *
+ * @example
+ * ```typescript
+ * import { createNodeServer } from 'docusaurus-plugin-mcp-server/adapters';
+ *
+ * const server = createNodeServer({
+ *   docsPath: './build/mcp/docs.json',
+ *   indexPath: './build/mcp/search-index.json',
+ *   name: 'my-docs',
+ * });
+ *
+ * server.listen(3456, () => {
+ *   console.log('MCP server running at http://localhost:3456');
+ * });
+ * ```
+ */
+
+/**
+ * Options for the Node.js MCP server
+ */
+interface NodeServerOptions extends McpServerFileConfig {
+    /**
+     * CORS origin to allow. Defaults to '*' (all origins).
+     * Set to a specific origin or false to disable CORS headers.
+     */
+    corsOrigin?: string | false;
+}
+/**
+ * Create a Node.js request handler for the MCP server.
+ *
+ * This returns a handler function compatible with `http.createServer()`.
+ * For a complete server, use `createNodeServer()` instead.
+ */
+declare function createNodeHandler(options: NodeServerOptions): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+/**
+ * Create a complete Node.js HTTP server for the MCP server.
+ *
+ * This is the simplest way to run an MCP server locally for development.
+ */
+declare function createNodeServer(options: NodeServerOptions): Server;
+
+export { type CloudflareAdapterConfig, type GeneratedFile, type GeneratorOptions, type NetlifyContext, type NetlifyEvent, type NodeServerOptions, type Platform, type VercelRequest, type VercelResponse, createCloudflareHandler, createNetlifyHandler, createNodeHandler, createNodeServer, createVercelHandler, generateAdapterFiles };

package/dist/adapters-entry.d.ts

@@ -1,5 +1,5 @@
-import { IncomingMessage, ServerResponse } from 'node:http';
-import { M as McpServerConfig, P as ProcessedDoc } from './index-4g0ZZK3z.js';
+import { IncomingMessage, ServerResponse, Server } from 'node:http';
+import { M as McpServerConfig, P as ProcessedDoc, a as McpServerFileConfig } from './index-j-CdaS6k.js';
 
 /**
  * Vercel adapter for MCP server
@@ -177,4 +177,49 @@ interface GeneratedFile {
  */
 declare function generateAdapterFiles(options: GeneratorOptions): GeneratedFile[];
 
-export { type CloudflareAdapterConfig, type GeneratedFile, type GeneratorOptions, type NetlifyContext, type NetlifyEvent, type Platform, type VercelRequest, type VercelResponse, createCloudflareHandler, createNetlifyHandler, createVercelHandler, generateAdapterFiles };
+/**
+ * Node.js adapter for MCP server
+ *
+ * Creates a standalone HTTP server for local development and testing.
+ *
+ * @example
+ * ```typescript
+ * import { createNodeServer } from 'docusaurus-plugin-mcp-server/adapters';
+ *
+ * const server = createNodeServer({
+ *   docsPath: './build/mcp/docs.json',
+ *   indexPath: './build/mcp/search-index.json',
+ *   name: 'my-docs',
+ * });
+ *
+ * server.listen(3456, () => {
+ *   console.log('MCP server running at http://localhost:3456');
+ * });
+ * ```
+ */
+
+/**
+ * Options for the Node.js MCP server
+ */
+interface NodeServerOptions extends McpServerFileConfig {
+    /**
+     * CORS origin to allow. Defaults to '*' (all origins).
+     * Set to a specific origin or false to disable CORS headers.
+     */
+    corsOrigin?: string | false;
+}
+/**
+ * Create a Node.js request handler for the MCP server.
+ *
+ * This returns a handler function compatible with `http.createServer()`.
+ * For a complete server, use `createNodeServer()` instead.
+ */
+declare function createNodeHandler(options: NodeServerOptions): (req: IncomingMessage, res: ServerResponse) => Promise<void>;
+/**
+ * Create a complete Node.js HTTP server for the MCP server.
+ *
+ * This is the simplest way to run an MCP server locally for development.
+ */
+declare function createNodeServer(options: NodeServerOptions): Server;
+
+export { type CloudflareAdapterConfig, type GeneratedFile, type GeneratorOptions, type NetlifyContext, type NetlifyEvent, type NodeServerOptions, type Platform, type VercelRequest, type VercelResponse, createCloudflareHandler, createNetlifyHandler, createNodeHandler, createNodeServer, createVercelHandler, generateAdapterFiles };