docusaurus-plugin-mcp-server 0.9.0 → 0.10.1

package/dist/adapters-entry.d.mts

@@ -1,225 +0,0 @@
-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
- *
- * Creates a Vercel serverless function handler for the MCP server.
- *
- * @example
- * // api/mcp.js
- * const { createVercelHandler } = require('docusaurus-plugin-mcp-server/adapters');
- * const path = require('path');
- *
- * module.exports = createVercelHandler({
- *   docsPath: path.join(__dirname, '../build/mcp/docs.json'),
- *   indexPath: path.join(__dirname, '../build/mcp/search-index.json'),
- *   name: 'my-docs',
- *   baseUrl: 'https://docs.example.com',
- * });
- */
-
-/**
- * Vercel request object (extends Node.js IncomingMessage)
- */
-interface VercelRequest extends IncomingMessage {
-    body?: unknown;
-}
-/**
- * Vercel response object (extends Node.js ServerResponse)
- */
-interface VercelResponse extends ServerResponse {
-    status(code: number): VercelResponse;
-    json(data: unknown): void;
-}
-/**
- * Create a Vercel serverless function handler for the MCP server
- *
- * Uses the MCP SDK's StreamableHTTPServerTransport for proper protocol handling.
- */
-declare function createVercelHandler(config: McpServerConfig): (req: VercelRequest, res: VercelResponse) => Promise<void>;
-
-/**
- * Netlify adapter for MCP server
- *
- * Creates a Netlify serverless function handler for the MCP server.
- * Converts Netlify's AWS Lambda-style events to Web Standard Request
- * and uses the MCP SDK's transport for proper protocol handling.
- *
- * @example
- * // netlify/functions/mcp.js
- * const { createNetlifyHandler } = require('docusaurus-plugin-mcp-server/adapters');
- * const path = require('path');
- *
- * exports.handler = createNetlifyHandler({
- *   docsPath: path.join(__dirname, '../../build/mcp/docs.json'),
- *   indexPath: path.join(__dirname, '../../build/mcp/search-index.json'),
- *   name: 'my-docs',
- *   baseUrl: 'https://docs.example.com',
- * });
- */
-
-/**
- * Netlify event object (simplified interface)
- */
-interface NetlifyEvent {
-    httpMethod: string;
-    headers: Record<string, string | undefined>;
-    body: string | null;
-    isBase64Encoded?: boolean;
-    path?: string;
-    rawUrl?: string;
-}
-/**
- * Netlify context object (simplified interface)
- */
-interface NetlifyContext {
-    functionName: string;
-    functionVersion?: string;
-    invokedFunctionArn?: string;
-    memoryLimitInMB?: string;
-    awsRequestId?: string;
-    logGroupName?: string;
-    logStreamName?: string;
-    getRemainingTimeInMillis?: () => number;
-}
-/**
- * Netlify function response
- */
-interface NetlifyResponse {
-    statusCode: number;
-    headers?: Record<string, string>;
-    body?: string;
-}
-/**
- * Create a Netlify serverless function handler for the MCP server
- *
- * Uses the MCP SDK's WebStandardStreamableHTTPServerTransport for
- * proper protocol handling.
- */
-declare function createNetlifyHandler(config: McpServerConfig): (event: NetlifyEvent, _context: NetlifyContext) => Promise<NetlifyResponse>;
-
-/**
- * Cloudflare Workers adapter for MCP server
- *
- * Creates a Cloudflare Workers fetch handler for the MCP server.
- * Since Workers can't access the filesystem, this adapter requires
- * pre-loaded docs and search index data.
- *
- * Uses the MCP SDK's WebStandardStreamableHTTPServerTransport for proper
- * protocol handling with Web Standard Request/Response.
- *
- * @example
- * // src/worker.js
- * import { createCloudflareHandler } from 'docusaurus-plugin-mcp-server/adapters';
- * import docs from '../build/mcp/docs.json';
- * import searchIndex from '../build/mcp/search-index.json';
- *
- * export default {
- *   fetch: createCloudflareHandler({
- *     docs,
- *     searchIndexData: searchIndex,
- *     name: 'my-docs',
- *     baseUrl: 'https://docs.example.com',
- *   }),
- * };
- */
-
-/**
- * Config for Cloudflare Workers adapter
- */
-interface CloudflareAdapterConfig {
-    /** Pre-loaded docs data (imported from docs.json) */
-    docs: Record<string, ProcessedDoc>;
-    /** Pre-loaded search index data (imported from search-index.json) */
-    searchIndexData: Record<string, unknown>;
-    /** Server name */
-    name: string;
-    /** Server version */
-    version?: string;
-    /** Base URL for constructing full page URLs */
-    baseUrl?: string;
-}
-/**
- * Create a Cloudflare Workers fetch handler for the MCP server
- *
- * Uses the MCP SDK's WebStandardStreamableHTTPServerTransport for
- * proper protocol handling.
- */
-declare function createCloudflareHandler(config: CloudflareAdapterConfig): (request: Request) => Promise<Response>;
-
-/**
- * Adapter file generator
- *
- * Generates platform-specific adapter files for deploying the MCP server.
- */
-type Platform = 'vercel' | 'netlify' | 'cloudflare';
-interface GeneratorOptions {
-    /** Target platform */
-    platform: Platform;
-    /** Server name */
-    name: string;
-    /** Base URL for the documentation site */
-    baseUrl: string;
-    /** Output path for the generated files (defaults to current directory) */
-    outputPath?: string;
-}
-interface GeneratedFile {
-    /** Relative path for the file */
-    path: string;
-    /** File contents */
-    content: string;
-    /** Description of the file */
-    description: string;
-}
-/**
- * Generate adapter files for a specific platform
- */
-declare function generateAdapterFiles(options: GeneratorOptions): GeneratedFile[];
-
-/**
- * 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 };