docusaurus-plugin-mcp-server 0.5.0

package/dist/adapters-entry.d.ts

@@ -0,0 +1,180 @@
+import { IncomingMessage, ServerResponse } from 'node:http';
+import { M as McpServerConfig, P as ProcessedDoc } from './index-CzA4FjeE.js';
+
+/**
+ * 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[];
+
+export { type CloudflareAdapterConfig, type GeneratedFile, type GeneratorOptions, type NetlifyContext, type NetlifyEvent, type Platform, type VercelRequest, type VercelResponse, createCloudflareHandler, createNetlifyHandler, createVercelHandler, generateAdapterFiles };