agent-consultation-mcp 1.0.0

package/dist/index.js

@@ -0,0 +1,224 @@
+#!/usr/bin/env node
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { z } from 'zod';
+import { getConfigManager, CONSULTATION_MODES } from './config/index.js';
+import { logger } from './utils/index.js';
+import { consultAgent, continueConversation, endConversation, } from './server/index.js';
+import { initializeProviders } from './providers/index.js';
+import { startConfigUI, openWebUI } from './api/index.js';
+/**
+ * Parse CLI arguments
+ */
+function parseArgs() {
+    const args = process.argv.slice(2);
+    // Check for config mode
+    if (args.includes('--config') || args.includes('config') || args.includes('-c')) {
+        // Parse port if provided
+        const portIndex = args.findIndex((a) => a === '--port' || a === '-p');
+        let port;
+        if (portIndex !== -1 && args[portIndex + 1]) {
+            port = parseInt(args[portIndex + 1], 10);
+            if (isNaN(port) || port < 1 || port > 65535) {
+                console.error('Invalid port number. Using default.');
+                port = undefined;
+            }
+        }
+        return { mode: 'config', port };
+    }
+    // Check for help
+    if (args.includes('--help') || args.includes('-h')) {
+        console.log(`
+Agent Consultation MCP - Get second opinions from DeepSeek Reasoner
+
+Usage:
+  npx agent-consultation-mcp           Start MCP server (stdio transport)
+  npx agent-consultation-mcp --config  Open configuration UI in browser
+  npx agent-consultation-mcp --help    Show this help message
+
+Options:
+  --config, -c         Open configuration UI to manage DeepSeek API key
+  --port <number>, -p  Set port for config UI (default: 3456)
+  --help, -h           Show this help message
+
+Configuration UI:
+  Configure your DeepSeek API key through a web interface at
+  http://127.0.0.1:3456 (localhost only for security)
+
+Supported Models:
+  - deepseek-reasoner (default) - Deep reasoning for complex tasks
+  - deepseek-chat - Fast responses for simple queries
+
+Consultation Modes:
+  - debug           - Systematic error analysis and debugging
+  - analyzeCode     - Code review for bugs, security, performance
+  - reviewArchitecture - System design and architecture decisions
+  - validatePlan    - Implementation plan review and validation
+  - explainConcept  - Learn concepts with examples and analogies
+  - general         - General second opinion (default)
+`);
+        process.exit(0);
+    }
+    return { mode: 'mcp' };
+}
+/**
+ * Initialize and start the MCP server
+ */
+async function main() {
+    const { mode, port } = parseArgs();
+    // Config UI mode
+    if (mode === 'config') {
+        try {
+            await startConfigUI({ port, openBrowser: true });
+        }
+        catch (error) {
+            console.error('Failed to start config UI:', error instanceof Error ? error.message : error);
+            process.exit(1);
+        }
+        return;
+    }
+    // MCP server mode (default)
+    // Initialize configuration
+    const configManager = getConfigManager();
+    await configManager.init();
+    // Initialize providers
+    await initializeProviders();
+    logger.info('Starting Agent Consultation MCP Server');
+    // Create MCP server
+    const server = new McpServer({
+        name: 'agent-consultation',
+        version: '2.0.0',
+    });
+    // Register consult_agent tool
+    server.tool('consult_agent', 'Consult DeepSeek Reasoner for a second opinion on debugging, code review, architecture, or learning', {
+        question: z.string().describe('The question or problem to get advice on'),
+        mode: z
+            .enum(CONSULTATION_MODES)
+            .optional()
+            .describe('Consultation mode: debug, analyzeCode, reviewArchitecture, validatePlan, explainConcept, or general'),
+        context: z
+            .string()
+            .optional()
+            .describe('Additional context like code snippets, error messages, or plans to analyze'),
+    }, async (args) => {
+        // Open Web UI in browser when tool is triggered
+        openWebUI().catch(() => { });
+        try {
+            const result = await consultAgent(args);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('consult_agent failed', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Register continue_conversation tool
+    server.tool('continue_conversation', 'Continue an existing conversation with DeepSeek', {
+        conversationId: z
+            .string()
+            .uuid()
+            .describe('The conversation ID to continue'),
+        message: z.string().describe('Your follow-up message'),
+    }, async (args) => {
+        // Open Web UI in browser when tool is triggered
+        openWebUI().catch(() => { });
+        try {
+            const result = await continueConversation(args);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('continue_conversation failed', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Register end_conversation tool
+    server.tool('end_conversation', 'End an active conversation with DeepSeek', {
+        conversationId: z
+            .string()
+            .uuid()
+            .describe('The conversation ID to end'),
+    }, async (args) => {
+        // Open Web UI in browser when tool is triggered
+        openWebUI().catch(() => { });
+        try {
+            const result = await endConversation(args);
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: JSON.stringify(result, null, 2),
+                    },
+                ],
+            };
+        }
+        catch (error) {
+            logger.error('end_conversation failed', {
+                error: error instanceof Error ? error.message : 'Unknown error',
+            });
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `Error: ${error instanceof Error ? error.message : 'Unknown error'}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    // Connect using stdio transport
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    logger.info('MCP Server connected and ready');
+}
+// Handle process signals
+process.on('SIGINT', () => {
+    logger.info('Received SIGINT, shutting down');
+    process.exit(0);
+});
+process.on('SIGTERM', () => {
+    logger.info('Received SIGTERM, shutting down');
+    process.exit(0);
+});
+// Start the server
+main().catch((error) => {
+    logger.error('Failed to start MCP server', {
+        error: error instanceof Error ? error.message : 'Unknown error',
+    });
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/providers/base.d.ts

@@ -0,0 +1,44 @@
+import type { ProviderType } from '../types/index.js';
+import type { IProvider, ProviderMessage, CompletionOptions, ProviderResponse, ProviderErrorInfo } from './types.js';
+/**
+ * Custom error class for provider errors
+ */
+export declare class ProviderError extends Error {
+    readonly info: ProviderErrorInfo;
+    constructor(info: ProviderErrorInfo);
+}
+/**
+ * Abstract base class for all providers
+ */
+export declare abstract class BaseProvider implements IProvider {
+    abstract readonly name: ProviderType;
+    /**
+     * Get the API key for this provider
+     */
+    protected getApiKey(): string | undefined;
+    /**
+     * Check if the provider is configured
+     */
+    isConfigured(): boolean;
+    /**
+     * Create a chat completion - must be implemented by subclasses
+     */
+    abstract createCompletion(messages: ProviderMessage[], options: CompletionOptions): Promise<ProviderResponse>;
+    /**
+     * Format system prompt for models that don't support it directly
+     * Prepends system prompt to the first user message
+     */
+    protected formatSystemPromptAsUser(messages: ProviderMessage[], systemPrompt?: string): ProviderMessage[];
+    /**
+     * Log completion request
+     */
+    protected logRequest(model: string, messageCount: number, options: CompletionOptions): void;
+    /**
+     * Log completion response
+     */
+    protected logResponse(response: ProviderResponse): void;
+    /**
+     * Create a standardized provider error
+     */
+    protected createError(code: string, message: string, retryable: boolean, statusCode?: number): ProviderError;
+}

package/dist/providers/base.js

@@ -0,0 +1,84 @@
+import { getConfigManager } from '../config/index.js';
+import { logger } from '../utils/index.js';
+/**
+ * Custom error class for provider errors
+ */
+export class ProviderError extends Error {
+    info;
+    constructor(info) {
+        super(info.message);
+        this.name = 'ProviderError';
+        this.info = info;
+    }
+}
+/**
+ * Abstract base class for all providers
+ */
+export class BaseProvider {
+    /**
+     * Get the API key for this provider
+     */
+    getApiKey() {
+        return getConfigManager().getProviderKey(this.name);
+    }
+    /**
+     * Check if the provider is configured
+     */
+    isConfigured() {
+        return getConfigManager().isProviderConfigured(this.name);
+    }
+    /**
+     * Format system prompt for models that don't support it directly
+     * Prepends system prompt to the first user message
+     */
+    formatSystemPromptAsUser(messages, systemPrompt) {
+        if (!systemPrompt)
+            return messages;
+        const result = [...messages];
+        const firstUserIndex = result.findIndex((m) => m.role === 'user');
+        if (firstUserIndex >= 0) {
+            result[firstUserIndex] = {
+                ...result[firstUserIndex],
+                content: `[System Instructions]\n${systemPrompt}\n\n[User Query]\n${result[firstUserIndex].content}`,
+            };
+        }
+        return result;
+    }
+    /**
+     * Log completion request
+     */
+    logRequest(model, messageCount, options) {
+        logger.info('Provider completion request', {
+            provider: this.name,
+            model,
+            messageCount,
+            maxTokens: options.maxTokens,
+            hasSystemPrompt: !!options.systemPrompt,
+        });
+    }
+    /**
+     * Log completion response
+     */
+    logResponse(response) {
+        logger.info('Provider completion response', {
+            provider: this.name,
+            model: response.model,
+            finishReason: response.finishReason,
+            usage: response.usage,
+            hasReasoningContent: !!response.reasoningContent,
+        });
+    }
+    /**
+     * Create a standardized provider error
+     */
+    createError(code, message, retryable, statusCode) {
+        return new ProviderError({
+            provider: this.name,
+            code,
+            message,
+            retryable,
+            statusCode,
+        });
+    }
+}
+//# sourceMappingURL=base.js.map

package/dist/providers/base.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base.js","sourceRoot":"","sources":["../../src/providers/base.ts"],"names":[],"mappings":"AAQA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AACtD,OAAO,EAAE,MAAM,EAAE,MAAM,mBAAmB,CAAC;AAE3C;;GAEG;AACH,MAAM,OAAO,aAAc,SAAQ,KAAK;IAC7B,IAAI,CAAoB;IAEjC,YAAY,IAAuB;QACjC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACpB,IAAI,CAAC,IAAI,GAAG,eAAe,CAAC;QAC5B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;IACnB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAgB,YAAY;IAGhC;;OAEG;IACO,SAAS;QACjB,OAAO,gBAAgB,EAAE,CAAC,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtD,CAAC;IAED;;OAEG;IACH,YAAY;QACV,OAAO,gBAAgB,EAAE,CAAC,oBAAoB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC;IAUD;;;OAGG;IACO,wBAAwB,CAChC,QAA2B,EAC3B,YAAqB;QAErB,IAAI,CAAC,YAAY;YAAE,OAAO,QAAQ,CAAC;QAEnC,MAAM,MAAM,GAAG,CAAC,GAAG,QAAQ,CAAC,CAAC;QAC7B,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;QAElE,IAAI,cAAc,IAAI,CAAC,EAAE,CAAC;YACxB,MAAM,CAAC,cAAc,CAAC,GAAG;gBACvB,GAAG,MAAM,CAAC,cAAc,CAAC;gBACzB,OAAO,EAAE,0BAA0B,YAAY,qBAAqB,MAAM,CAAC,cAAc,CAAC,CAAC,OAAO,EAAE;aACrG,CAAC;QACJ,CAAC;QAED,OAAO,MAAM,CAAC;IAChB,CAAC;IAED;;OAEG;IACO,UAAU,CAClB,KAAa,EACb,YAAoB,EACpB,OAA0B;QAE1B,MAAM,CAAC,IAAI,CAAC,6BAA6B,EAAE;YACzC,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,KAAK;YACL,YAAY;YACZ,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,eAAe,EAAE,CAAC,CAAC,OAAO,CAAC,YAAY;SACxC,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACO,WAAW,CAAC,QAA0B;QAC9C,MAAM,CAAC,IAAI,CAAC,8BAA8B,EAAE;YAC1C,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,YAAY,EAAE,QAAQ,CAAC,YAAY;YACnC,KAAK,EAAE,QAAQ,CAAC,KAAK;YACrB,mBAAmB,EAAE,CAAC,CAAC,QAAQ,CAAC,gBAAgB;SACjD,CAAC,CAAC;IACL,CAAC;IAED;;OAEG;IACO,WAAW,CACnB,IAAY,EACZ,OAAe,EACf,SAAkB,EAClB,UAAmB;QAEnB,OAAO,IAAI,aAAa,CAAC;YACvB,QAAQ,EAAE,IAAI,CAAC,IAAI;YACnB,IAAI;YACJ,OAAO;YACP,SAAS;YACT,UAAU;SACX,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/providers/deepseek.d.ts

@@ -0,0 +1,30 @@
+import type { ProviderType } from '../types/index.js';
+import type { ProviderMessage, CompletionOptions, ProviderResponse } from './types.js';
+import { BaseProvider } from './base.js';
+/**
+ * DeepSeek Provider - Uses OpenAI-compatible SDK
+ */
+export declare class DeepSeekProvider extends BaseProvider {
+    readonly name: ProviderType;
+    private client;
+    /**
+     * Get or create the OpenAI-compatible client for DeepSeek
+     */
+    private getClient;
+    /**
+     * Check if a model is a reasoning model
+     */
+    private isReasoningModel;
+    /**
+     * Check if a model supports system prompts
+     */
+    private supportsSystemPrompt;
+    /**
+     * Get the actual API model ID
+     */
+    private getApiModel;
+    /**
+     * Create a chat completion
+     */
+    createCompletion(messages: ProviderMessage[], options: CompletionOptions): Promise<ProviderResponse>;
+}

package/dist/providers/deepseek.js

@@ -0,0 +1,148 @@
+import OpenAI from 'openai';
+import { MODEL_CONFIG } from '../types/index.js';
+import { BaseProvider } from './base.js';
+import { logger } from '../utils/index.js';
+/**
+ * DeepSeek API base URL
+ */
+const DEEPSEEK_BASE_URL = 'https://api.deepseek.com';
+/**
+ * DeepSeek Provider - Uses OpenAI-compatible SDK
+ */
+export class DeepSeekProvider extends BaseProvider {
+    name = 'deepseek';
+    client = null;
+    /**
+     * Get or create the OpenAI-compatible client for DeepSeek
+     */
+    getClient() {
+        if (!this.client) {
+            const apiKey = this.getApiKey();
+            if (!apiKey) {
+                throw this.createError('AUTH_ERROR', 'DeepSeek API key not configured', false);
+            }
+            this.client = new OpenAI({
+                apiKey,
+                baseURL: DEEPSEEK_BASE_URL,
+            });
+        }
+        return this.client;
+    }
+    /**
+     * Check if a model is a reasoning model
+     */
+    isReasoningModel(model) {
+        const config = MODEL_CONFIG[model];
+        return config?.isReasoning ?? false;
+    }
+    /**
+     * Check if a model supports system prompts
+     */
+    supportsSystemPrompt(model) {
+        const config = MODEL_CONFIG[model];
+        return config?.supportsSystemPrompt ?? true;
+    }
+    /**
+     * Get the actual API model ID
+     */
+    getApiModel(model) {
+        const config = MODEL_CONFIG[model];
+        return config?.apiModel ?? model;
+    }
+    /**
+     * Create a chat completion
+     */
+    async createCompletion(messages, options) {
+        const client = this.getClient();
+        const apiModel = this.getApiModel(options.model);
+        const isReasoning = this.isReasoningModel(options.model);
+        const supportsSystem = this.supportsSystemPrompt(options.model);
+        this.logRequest(apiModel, messages.length, options);
+        const startTime = Date.now();
+        try {
+            // Build messages array
+            let chatMessages = [];
+            // Handle system prompt
+            if (options.systemPrompt) {
+                if (supportsSystem) {
+                    chatMessages.push({
+                        role: 'system',
+                        content: options.systemPrompt,
+                    });
+                }
+                else {
+                    // For reasoning models, prepend to first user message
+                    messages = this.formatSystemPromptAsUser(messages, options.systemPrompt);
+                }
+            }
+            // Add conversation messages
+            chatMessages.push(...messages.map((m) => ({
+                role: m.role,
+                content: m.content,
+            })));
+            // Build request parameters
+            const requestParams = {
+                model: apiModel,
+                messages: chatMessages,
+            };
+            // Handle token limits differently for reasoning models
+            if (isReasoning) {
+                // Reasoning models use max_completion_tokens
+                // eslint-disable-next-line @typescript-eslint/no-explicit-any
+                requestParams.max_completion_tokens =
+                    options.maxTokens || 4096;
+                // DeepSeek reasoner: temperature must be 0
+                requestParams.temperature = 0;
+            }
+            else {
+                // Standard models use max_tokens
+                requestParams.max_tokens = options.maxTokens || 4096;
+                // Set temperature for non-reasoning models
+                if (options.temperature !== undefined) {
+                    requestParams.temperature = options.temperature;
+                }
+            }
+            const response = await client.chat.completions.create(requestParams);
+            const choice = response.choices[0];
+            const content = choice?.message?.content || '';
+            // Extract reasoning content if present (DeepSeek Reasoner specific)
+            // eslint-disable-next-line @typescript-eslint/no-explicit-any
+            const reasoningContent = choice?.message
+                ?.reasoning_content;
+            const responseTime = Date.now() - startTime;
+            if (reasoningContent) {
+                logger.debug('Reasoning content received', {
+                    model: apiModel,
+                    reasoningLength: reasoningContent.length,
+                    thinkingTime: responseTime,
+                });
+            }
+            const result = {
+                content,
+                model: response.model,
+                usage: response.usage
+                    ? {
+                        promptTokens: response.usage.prompt_tokens,
+                        completionTokens: response.usage.completion_tokens,
+                        totalTokens: response.usage.total_tokens,
+                    }
+                    : undefined,
+                finishReason: choice?.finish_reason || undefined,
+                reasoningContent,
+                responseTime,
+            };
+            this.logResponse(result);
+            return result;
+        }
+        catch (error) {
+            if (error instanceof OpenAI.APIError) {
+                const retryable = error.status === 429 ||
+                    error.status === 500 ||
+                    error.status === 503;
+                throw this.createError(error.code || 'API_ERROR', error.message, retryable, error.status);
+            }
+            throw error;
+        }
+    }
+}
+//# sourceMappingURL=deepseek.js.map

package/dist/providers/deepseek.js.map

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

package/dist/providers/index.d.ts

@@ -0,0 +1,5 @@
+export type { IProvider, ProviderMessage, CompletionOptions, ProviderResponse, TokenUsage, ProviderErrorInfo, ModelConfig, } from './types.js';
+export { BaseProvider, ProviderError } from './base.js';
+export { ProviderRegistry, getProviderRegistry, initializeProviders, } from './registry.js';
+export { DeepSeekProvider } from './deepseek.js';
+export { OpenAIProvider } from './openai.js';

package/dist/providers/index.js

@@ -0,0 +1,8 @@
+// Base
+export { BaseProvider, ProviderError } from './base.js';
+// Registry
+export { ProviderRegistry, getProviderRegistry, initializeProviders, } from './registry.js';
+// Providers
+export { DeepSeekProvider } from './deepseek.js';
+export { OpenAIProvider } from './openai.js';
+//# sourceMappingURL=index.js.map

package/dist/providers/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/providers/index.ts"],"names":[],"mappings":"AAWA,OAAO;AACP,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,WAAW,CAAC;AAExD,WAAW;AACX,OAAO,EACL,gBAAgB,EAChB,mBAAmB,EACnB,mBAAmB,GACpB,MAAM,eAAe,CAAC;AAEvB,YAAY;AACZ,OAAO,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/providers/openai.d.ts

@@ -0,0 +1,30 @@
+import type { ProviderType } from '../types/index.js';
+import type { ProviderMessage, CompletionOptions, ProviderResponse } from './types.js';
+import { BaseProvider } from './base.js';
+/**
+ * OpenAI Provider - GPT-5.2 models
+ */
+export declare class OpenAIProvider extends BaseProvider {
+    readonly name: ProviderType;
+    private client;
+    /**
+     * Get or create the OpenAI client
+     */
+    private getClient;
+    /**
+     * Check if a model is a reasoning model
+     */
+    private isReasoningModel;
+    /**
+     * Get reasoning effort for the model
+     */
+    private getReasoningEffort;
+    /**
+     * Get the actual API model ID
+     */
+    private getApiModel;
+    /**
+     * Create a chat completion
+     */
+    createCompletion(messages: ProviderMessage[], options: CompletionOptions): Promise<ProviderResponse>;
+}