mongo.do 0.1.0

package/dist/mcp/adapters/anthropic-adapter.js

@@ -0,0 +1,409 @@
+/**
+ * Anthropic SDK Adapter for MCP
+ *
+ * Adapts MCP server tools to Anthropic's tool calling format.
+ * Supports Claude models with tool use capabilities.
+ *
+ * Features:
+ * - Converts MCP tool definitions to Anthropic format
+ * - Handles tool call execution with retry and timeout
+ * - Supports streaming responses for large outputs
+ * - Provides proper error mapping to Anthropic error types
+ *
+ * @see https://docs.anthropic.com/claude/docs/tool-use
+ */
+import { BaseAdapter } from './base-adapter';
+import { McpError, McpErrorCode, ToolNotFoundError } from './errors';
+import { streamTextContent, streamToWebSocket, } from './streaming';
+// =============================================================================
+// Constants
+// =============================================================================
+const DEFAULT_STREAMING_THRESHOLD = 100 * 1024; // 100KB
+const ANTHROPIC_TOOL_NAME_REGEX = /^[a-zA-Z0-9_]+$/;
+// =============================================================================
+// Anthropic Adapter Class
+// =============================================================================
+/**
+ * Anthropic SDK Adapter
+ *
+ * Converts MCP tools to Anthropic's tool format and handles
+ * tool execution with proper error handling and streaming support.
+ *
+ * @example
+ * ```typescript
+ * const mcpServer = createMcpServer({ dbAccess })
+ * const adapter = new AnthropicAdapter({
+ *   server: mcpServer,
+ *   retry: { maxRetries: 3 },
+ *   timeout: { requestTimeoutMs: 30000 },
+ * })
+ *
+ * await adapter.initialize()
+ *
+ * // Get tools for Anthropic API
+ * const tools = await adapter.getTools()
+ *
+ * // Handle tool use from Claude response
+ * const result = await adapter.handleToolUse(toolUseBlock)
+ * ```
+ */
+export class AnthropicAdapter extends BaseAdapter {
+    streamingThreshold;
+    verboseErrors;
+    transformToolName;
+    toolCache = new Map();
+    initialized = false;
+    constructor(config) {
+        super(config);
+        this.streamingThreshold = config.streamingThreshold ?? DEFAULT_STREAMING_THRESHOLD;
+        this.verboseErrors = config.verboseErrors ?? process.env.NODE_ENV === 'development';
+        this.transformToolName = config.transformToolName ?? this.defaultToolNameTransform.bind(this);
+    }
+    /**
+     * Adapter name for logging
+     */
+    get adapterName() {
+        return 'anthropic';
+    }
+    // ===========================================================================
+    // Lifecycle
+    // ===========================================================================
+    /**
+     * Initialize the adapter
+     *
+     * Fetches all available tools from the MCP server and converts
+     * them to Anthropic format. Caches the converted tools for reuse.
+     */
+    async initialize() {
+        if (this.initialized) {
+            return;
+        }
+        this.log('info', 'Initializing Anthropic adapter');
+        try {
+            const mcpTools = await this.server.listTools();
+            for (const tool of mcpTools) {
+                const anthropicTool = this.convertTool(tool);
+                this.toolCache.set(tool.name, anthropicTool);
+                this.log('debug', `Registered tool: ${tool.name} -> ${anthropicTool.name}`);
+            }
+            this.initialized = true;
+            this.log('info', `Anthropic adapter initialized with ${this.toolCache.size} tools`);
+        }
+        catch (error) {
+            this.log('error', 'Failed to initialize Anthropic adapter', { error });
+            throw McpError.fromError(error instanceof Error ? error : new Error(String(error)));
+        }
+    }
+    /**
+     * Cleanup adapter resources
+     */
+    async cleanup() {
+        this.toolCache.clear();
+        this.initialized = false;
+        this.log('info', 'Anthropic adapter cleaned up');
+    }
+    // ===========================================================================
+    // Tool Conversion
+    // ===========================================================================
+    /**
+     * Default tool name transformation
+     *
+     * Anthropic requires tool names to match [a-zA-Z0-9_]+
+     */
+    defaultToolNameTransform(name) {
+        // Replace invalid characters with underscores
+        let transformed = name.replace(/[^a-zA-Z0-9_]/g, '_');
+        // Remove leading/trailing underscores
+        transformed = transformed.replace(/^_+|_+$/g, '');
+        // Ensure it starts with a letter (prepend 'tool_' if needed)
+        if (!/^[a-zA-Z]/.test(transformed)) {
+            transformed = 'tool_' + transformed;
+        }
+        return transformed;
+    }
+    /**
+     * Convert MCP tool definition to Anthropic format
+     */
+    convertTool(mcpTool) {
+        const name = this.transformToolName(mcpTool.name);
+        if (!ANTHROPIC_TOOL_NAME_REGEX.test(name)) {
+            throw new McpError(McpErrorCode.InvalidParams, `Invalid tool name after transformation: ${name}`);
+        }
+        return {
+            name,
+            description: mcpTool.description,
+            input_schema: this.convertInputSchema(mcpTool.inputSchema),
+        };
+    }
+    /**
+     * Convert MCP JSON Schema to Anthropic input schema format
+     */
+    convertInputSchema(schema) {
+        const properties = {};
+        if (schema.properties) {
+            for (const [key, value] of Object.entries(schema.properties)) {
+                properties[key] = this.convertSchemaProperty(value);
+            }
+        }
+        return {
+            type: 'object',
+            properties,
+            ...(schema.required && { required: schema.required }),
+        };
+    }
+    /**
+     * Convert a single schema property
+     */
+    convertSchemaProperty(prop) {
+        const param = {
+            type: prop.type,
+            ...(prop.description && { description: prop.description }),
+        };
+        if ('enum' in prop && prop.enum) {
+            param.enum = prop.enum;
+        }
+        if ('items' in prop && prop.items) {
+            param.items = this.convertSchemaProperty(prop.items);
+        }
+        if ('properties' in prop && prop.properties) {
+            param.properties = {};
+            for (const [key, value] of Object.entries(prop.properties)) {
+                param.properties[key] = this.convertSchemaProperty(value);
+            }
+            if ('required' in prop && prop.required) {
+                param.required = prop.required;
+            }
+        }
+        return param;
+    }
+    // ===========================================================================
+    // Public API
+    // ===========================================================================
+    /**
+     * Get all tools in Anthropic format
+     *
+     * Returns an array of tool definitions suitable for use with
+     * the Anthropic API's `tools` parameter.
+     *
+     * @returns Array of Anthropic tool definitions
+     *
+     * @example
+     * ```typescript
+     * const tools = await adapter.getTools()
+     *
+     * const response = await anthropic.messages.create({
+     *   model: 'claude-3-opus-20240229',
+     *   tools,
+     *   messages: [{ role: 'user', content: 'Search for documents' }],
+     * })
+     * ```
+     */
+    async getTools() {
+        if (!this.initialized) {
+            await this.initialize();
+        }
+        return Array.from(this.toolCache.values());
+    }
+    /**
+     * Handle a tool use block from Claude's response
+     *
+     * Executes the requested tool and returns a tool result block
+     * suitable for inclusion in the next user message.
+     *
+     * @param toolUse - Tool use block from assistant message
+     * @returns Tool result block for user message
+     *
+     * @example
+     * ```typescript
+     * // In message handling loop:
+     * if (block.type === 'tool_use') {
+     *   const result = await adapter.handleToolUse(block)
+     *   userMessage.content.push(result)
+     * }
+     * ```
+     */
+    async handleToolUse(toolUse) {
+        const startTime = Date.now();
+        this.log('debug', `Handling tool use: ${toolUse.name}`, {
+            id: toolUse.id,
+            hasInput: Object.keys(toolUse.input).length > 0,
+        });
+        try {
+            // Find the original MCP tool name
+            const mcpToolName = this.findMcpToolName(toolUse.name);
+            if (!mcpToolName) {
+                throw new ToolNotFoundError(toolUse.name);
+            }
+            // Execute the tool
+            const response = await this.callTool(mcpToolName, toolUse.input);
+            // Convert to Anthropic format
+            return this.convertToolResponse(toolUse.id, response);
+        }
+        catch (error) {
+            const mcpError = McpError.fromError(error instanceof Error ? error : new Error(String(error)));
+            this.log('error', `Tool use failed: ${toolUse.name}`, {
+                id: toolUse.id,
+                error: mcpError.message,
+                duration: Date.now() - startTime,
+            });
+            return {
+                type: 'tool_result',
+                tool_use_id: toolUse.id,
+                content: this.formatErrorContent(mcpError),
+                is_error: true,
+            };
+        }
+    }
+    /**
+     * Handle multiple tool uses in parallel
+     *
+     * Executes multiple tool calls concurrently with configurable
+     * concurrency limit.
+     *
+     * @param toolUses - Array of tool use blocks
+     * @param concurrency - Maximum concurrent executions (default: 5)
+     * @returns Array of tool result blocks
+     */
+    async handleToolUses(toolUses, concurrency = 5) {
+        const results = [];
+        const executing = [];
+        for (const toolUse of toolUses) {
+            const promise = this.handleToolUse(toolUse).then((result) => {
+                results.push(result);
+            });
+            executing.push(promise);
+            if (executing.length >= concurrency) {
+                await Promise.race(executing);
+                // Remove completed promises by filtering based on Promise.race
+                const completed = await Promise.allSettled(executing);
+                const stillPending = [];
+                for (let i = 0; i < completed.length; i++) {
+                    if (completed[i].status !== 'fulfilled') {
+                        stillPending.push(executing[i]);
+                    }
+                }
+                executing.length = 0;
+                executing.push(...stillPending);
+            }
+        }
+        await Promise.all(executing);
+        return results;
+    }
+    /**
+     * Execute a tool with streaming response
+     *
+     * For large responses, streams the content through a WebSocket
+     * or returns an async iterator for custom handling.
+     *
+     * @param toolUse - Tool use block
+     * @param wsConfig - Optional WebSocket configuration for streaming
+     * @returns Tool result or stream
+     */
+    async handleToolUseStreaming(toolUse, wsConfig) {
+        const mcpToolName = this.findMcpToolName(toolUse.name);
+        if (!mcpToolName) {
+            throw new ToolNotFoundError(toolUse.name);
+        }
+        const response = await this.callTool(mcpToolName, toolUse.input);
+        const content = this.extractTextContent(response);
+        // Check if streaming is needed
+        if (content.length <= this.streamingThreshold) {
+            return this.convertToolResponse(toolUse.id, response);
+        }
+        // Stream the content
+        const stream = streamTextContent(content);
+        if (wsConfig) {
+            await streamToWebSocket(stream, {
+                ...wsConfig,
+                requestId: wsConfig.requestId ?? toolUse.id,
+            });
+            return {
+                type: 'tool_result',
+                tool_use_id: toolUse.id,
+                content: '[Content streamed via WebSocket]',
+            };
+        }
+        // Return async iterator for custom handling
+        return (async function* () {
+            for await (const chunk of streamTextContent(content)) {
+                yield chunk.content;
+            }
+        })();
+    }
+    // ===========================================================================
+    // Helper Methods
+    // ===========================================================================
+    /**
+     * Find the original MCP tool name from an Anthropic tool name
+     */
+    findMcpToolName(anthropicName) {
+        // First, try direct match
+        for (const [mcpName, tool] of this.toolCache) {
+            if (tool.name === anthropicName) {
+                return mcpName;
+            }
+        }
+        return undefined;
+    }
+    /**
+     * Convert MCP tool response to Anthropic format
+     */
+    convertToolResponse(toolUseId, response) {
+        const content = this.extractTextContent(response);
+        return {
+            type: 'tool_result',
+            tool_use_id: toolUseId,
+            content,
+            ...(response.isError && { is_error: response.isError }),
+        };
+    }
+    /**
+     * Extract text content from MCP response
+     */
+    extractTextContent(response) {
+        return response.content
+            .filter((c) => c.type === 'text')
+            .map((c) => c.text)
+            .join('\n');
+    }
+    /**
+     * Format error content for tool result
+     */
+    formatErrorContent(error) {
+        if (this.verboseErrors) {
+            return JSON.stringify({
+                error: error.message,
+                code: error.code,
+                retryable: error.retryable,
+                data: error.data,
+            });
+        }
+        return JSON.stringify({
+            error: error.message,
+        });
+    }
+}
+// =============================================================================
+// Factory Function
+// =============================================================================
+/**
+ * Create an Anthropic adapter for an MCP server
+ *
+ * @param config - Adapter configuration
+ * @returns Configured AnthropicAdapter instance
+ *
+ * @example
+ * ```typescript
+ * const adapter = createAnthropicAdapter({
+ *   server: mcpServer,
+ *   retry: { maxRetries: 3 },
+ * })
+ *
+ * await adapter.initialize()
+ * const tools = await adapter.getTools()
+ * ```
+ */
+export function createAnthropicAdapter(config) {
+    return new AnthropicAdapter(config);
+}
+//# sourceMappingURL=anthropic-adapter.js.map

package/dist/mcp/adapters/anthropic-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anthropic-adapter.js","sourceRoot":"","sources":["../../../src/mcp/adapters/anthropic-adapter.ts"],"names":[],"mappings":"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"}

package/dist/mcp/adapters/base-adapter.d.ts

@@ -0,0 +1,164 @@
+/**
+ * Base SDK Adapter for MCP
+ *
+ * Provides common functionality for SDK adapters:
+ * - Retry logic with exponential backoff
+ * - Timeout handling with AbortController
+ * - Request/response logging
+ * - Error normalization
+ *
+ * SDK adapters (Anthropic, Vercel) extend this base class.
+ */
+import type { McpServer } from '../server';
+import type { McpRequest, McpResponse, McpToolResponse } from '../types';
+/**
+ * Retry configuration for transient failures
+ */
+export interface RetryConfig {
+    /** Maximum number of retry attempts (default: 3) */
+    maxRetries: number;
+    /** Initial delay between retries in ms (default: 1000) */
+    initialDelayMs: number;
+    /** Maximum delay between retries in ms (default: 30000) */
+    maxDelayMs: number;
+    /** Exponential backoff multiplier (default: 2) */
+    backoffMultiplier: number;
+    /** Add jitter to delay to prevent thundering herd (default: true) */
+    jitter: boolean;
+}
+/**
+ * Timeout configuration for operations
+ */
+export interface TimeoutConfig {
+    /** Request timeout in ms (default: 30000) */
+    requestTimeoutMs: number;
+    /** Connection timeout in ms (default: 10000) */
+    connectTimeoutMs: number;
+    /** Idle timeout for streaming in ms (default: 60000) */
+    idleTimeoutMs: number;
+}
+/**
+ * Logging configuration
+ */
+export interface LogConfig {
+    /** Enable debug logging (default: false) */
+    debug: boolean;
+    /** Log request bodies (default: false) */
+    logRequests: boolean;
+    /** Log response bodies (default: false) */
+    logResponses: boolean;
+    /** Custom logger function */
+    logger?: (level: 'debug' | 'info' | 'warn' | 'error', message: string, data?: unknown) => void;
+}
+/**
+ * Base adapter configuration
+ */
+export interface BaseAdapterConfig {
+    /** MCP server instance */
+    server: McpServer;
+    /** Retry configuration */
+    retry?: Partial<RetryConfig>;
+    /** Timeout configuration */
+    timeout?: Partial<TimeoutConfig>;
+    /** Logging configuration */
+    log?: Partial<LogConfig>;
+}
+/**
+ * Abstract base class for SDK adapters
+ *
+ * Provides common infrastructure for adapting MCP servers to different SDKs.
+ * Subclasses implement SDK-specific tool formatting and request handling.
+ *
+ * @example
+ * ```typescript
+ * class MyAdapter extends BaseAdapter {
+ *   constructor(config: BaseAdapterConfig) {
+ *     super(config)
+ *   }
+ *
+ *   async formatTool(definition: McpToolDefinition): Promise<SDKTool> {
+ *     // Convert MCP tool to SDK format
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class BaseAdapter {
+    protected readonly server: McpServer;
+    protected readonly retryConfig: RetryConfig;
+    protected readonly timeoutConfig: TimeoutConfig;
+    protected readonly logConfig: LogConfig;
+    constructor(config: BaseAdapterConfig);
+    /**
+     * Log a message at the specified level
+     */
+    protected log(level: 'debug' | 'info' | 'warn' | 'error', message: string, data?: unknown): void;
+    /**
+     * Calculate delay for retry attempt with exponential backoff
+     */
+    protected calculateRetryDelay(attempt: number, baseDelay?: number): number;
+    /**
+     * Execute an operation with retry logic
+     *
+     * @param operation - Async operation to execute
+     * @param context - Context for logging
+     * @returns Result of the operation
+     * @throws McpError if all retries fail
+     */
+    protected withRetry<T>(operation: (attempt: number) => Promise<T>, context: string): Promise<T>;
+    /**
+     * Sleep for a specified duration
+     */
+    protected sleep(ms: number): Promise<void>;
+    /**
+     * Execute an operation with timeout
+     *
+     * @param operation - Async operation to execute
+     * @param timeoutMs - Timeout in milliseconds
+     * @param context - Context for error messages
+     * @returns Result of the operation
+     * @throws TimeoutError if operation times out
+     */
+    protected withTimeout<T>(operation: (signal: AbortSignal) => Promise<T>, timeoutMs: number, context: string): Promise<T>;
+    /**
+     * Execute an operation with both retry and timeout
+     */
+    protected withRetryAndTimeout<T>(operation: (signal: AbortSignal) => Promise<T>, context: string, timeoutMs?: number): Promise<T>;
+    /**
+     * Handle an MCP request with error handling and logging
+     */
+    protected handleRequest(request: McpRequest): Promise<McpResponse>;
+    /**
+     * Call a tool with error handling
+     */
+    protected callTool(name: string, args: Record<string, unknown>): Promise<McpToolResponse>;
+    /**
+     * Get the adapter name for logging
+     */
+    abstract get adapterName(): string;
+    /**
+     * Initialize the adapter
+     */
+    abstract initialize(): Promise<void>;
+    /**
+     * Cleanup adapter resources
+     */
+    abstract cleanup(): Promise<void>;
+}
+/**
+ * Result of a tool call with timing information
+ */
+export interface ToolCallResult {
+    response: McpToolResponse;
+    durationMs: number;
+    retries: number;
+}
+/**
+ * Batch operation options
+ */
+export interface BatchOptions {
+    /** Maximum concurrent operations */
+    concurrency?: number;
+    /** Continue on error */
+    continueOnError?: boolean;
+}
+//# sourceMappingURL=base-adapter.d.ts.map

package/dist/mcp/adapters/base-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"base-adapter.d.ts","sourceRoot":"","sources":["../../../src/mcp/adapters/base-adapter.ts"],"names":[],"mappings":"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"}