mcp-perplexity-pro 1.1.0

package/dist/launcher.js

@@ -0,0 +1,209 @@
+#!/usr/bin/env node
+import { spawn, execSync } from 'child_process';
+import { existsSync, statSync, readdirSync } from 'fs';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+import { discoverMcpPort } from './port-utils.js';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const projectRoot = dirname(__dirname);
+function log(message) {
+    console.error(`[mcp-perplexity-pro] ${message}`);
+}
+function checkBuildNeeded() {
+    const distPath = join(projectRoot, 'dist');
+    const srcPath = join(projectRoot, 'src');
+    // If dist doesn't exist, build is needed
+    if (!existsSync(distPath)) {
+        log('dist/ directory not found, build required');
+        return true;
+    }
+    // Check if any src file is newer than corresponding dist file
+    try {
+        const srcFiles = readdirSync(srcPath).filter(f => f.endsWith('.ts'));
+        const distFiles = readdirSync(distPath).filter(f => f.endsWith('.js'));
+        // If different number of files, build needed
+        if (srcFiles.length === 0) {
+            log('No TypeScript files found in src/');
+            return true;
+        }
+        if (distFiles.length === 0) {
+            log('No compiled JavaScript files found in dist/');
+            return true;
+        }
+        // Check timestamps - find newest src file and oldest dist file
+        let newestSrcTime = 0;
+        let oldestDistTime = Infinity;
+        for (const file of srcFiles) {
+            const srcStat = statSync(join(srcPath, file));
+            newestSrcTime = Math.max(newestSrcTime, srcStat.mtimeMs);
+        }
+        for (const file of distFiles) {
+            const distStat = statSync(join(distPath, file));
+            oldestDistTime = Math.min(oldestDistTime, distStat.mtimeMs);
+        }
+        if (newestSrcTime > oldestDistTime) {
+            log('Source files newer than compiled files, build required');
+            return true;
+        }
+        return false;
+    }
+    catch (error) {
+        log(`Error checking build status: ${error}`);
+        return true; // If we can't determine, err on side of building
+    }
+}
+function runBuild() {
+    log('Building MCP server...');
+    try {
+        execSync('npm run build', {
+            cwd: projectRoot,
+            stdio: 'inherit',
+            timeout: 120000, // 2 minute timeout
+        });
+        log('Build completed successfully');
+    }
+    catch (error) {
+        log(`Build failed: ${error}`);
+        process.exit(1);
+    }
+}
+function parseArgs() {
+    const args = process.argv.slice(2);
+    let httpPort = 8124; // Default port for Claude Code
+    let debugMode = false;
+    let clientMode = 'stdio'; // Default to stdio mode
+    for (const arg of args) {
+        if (arg.startsWith('--http-port=')) {
+            const portStr = arg.split('=')[1];
+            const port = parseInt(portStr, 10);
+            if (isNaN(port) || port <= 0 || port > 65535) {
+                log(`Invalid port number: ${portStr}`);
+                process.exit(1);
+            }
+            httpPort = port;
+        }
+        else if (arg.startsWith('--port=')) {
+            // Alternative port syntax
+            const portStr = arg.split('=')[1];
+            const port = parseInt(portStr, 10);
+            if (isNaN(port) || port <= 0 || port > 65535) {
+                log(`Invalid port number: ${portStr}`);
+                process.exit(1);
+            }
+            httpPort = port;
+        }
+        else if (arg === '--debug-mode') {
+            debugMode = true;
+        }
+        else if (arg === '--http-client') {
+            clientMode = 'http';
+        }
+        else if (arg === '--help' || arg === '-h') {
+            console.log(`
+mcp-perplexity-pro - Perplexity API MCP Server
+
+Usage:
+  mcp-perplexity-pro                    # Start HTTP server on port 8124 (for Claude Code)
+  mcp-perplexity-pro --http-port=8125   # Start HTTP server on port 8125 (for Claude Desktop)
+  mcp-perplexity-pro --debug-mode       # Enable debug logging to stdout
+
+Environment Variables:
+  PERPLEXITY_API_KEY    # Required: Your Perplexity API key
+  DEFAULT_MODEL         # Optional: Default model (default: sonar-reasoning-pro)
+  PROJECT_ROOT          # Optional: Project root directory
+  STORAGE_PATH          # Optional: Storage subdirectory (default: .perplexity)
+`);
+            process.exit(0);
+        }
+    }
+    return { httpPort, debugMode, clientMode };
+}
+function startServer(httpPort) {
+    const distPath = join(projectRoot, 'dist');
+    // Always use HTTP mode - start the HTTP server
+    log(`Starting HTTP server on port ${httpPort}...`);
+    const serverPath = join(distPath, 'index.js');
+    if (!existsSync(serverPath)) {
+        log(`Server file not found: ${serverPath}`);
+        process.exit(1);
+    }
+    const serverProcess = spawn('node', [serverPath, `--port=${httpPort}`], {
+        stdio: 'inherit',
+        env: { ...process.env },
+        cwd: projectRoot,
+    });
+    serverProcess.on('error', error => {
+        log(`Failed to start HTTP server: ${error}`);
+        process.exit(1);
+    });
+    serverProcess.on('exit', code => {
+        if (code !== 0) {
+            log(`HTTP server exited with code ${code}`);
+            process.exit(code || 1);
+        }
+    });
+    // Handle graceful shutdown
+    process.on('SIGINT', () => {
+        log('Shutting down HTTP server...');
+        serverProcess.kill('SIGINT');
+    });
+    process.on('SIGTERM', () => {
+        log('Shutting down HTTP server...');
+        serverProcess.kill('SIGTERM');
+    });
+}
+async function main() {
+    const { httpPort: preferredPort, debugMode, clientMode } = parseArgs();
+    // Set debug mode environment variable for child processes
+    if (debugMode) {
+        process.env.MCP_DEBUG_MODE = 'true';
+    }
+    // Discover the best port to use (check for existing servers or find available)
+    let discovery;
+    try {
+        discovery = await discoverMcpPort(preferredPort);
+        if (discovery.isExistingServer) {
+            if (clientMode === 'http') {
+                // For HTTP client mode (Claude Code), output connection URL to stdout and exit
+                console.log(`http://localhost:${discovery.port}`);
+                process.exit(0);
+            }
+            else {
+                // For stdio mode (Claude Desktop), log and exit as before
+                log(`Found existing healthy MCP server on port ${discovery.port}`);
+                log(`Clients can connect to: http://localhost:${discovery.port}`);
+                log(`This instance will exit as the shared server is already running.`);
+                process.exit(0);
+            }
+        }
+        else {
+            log(`No existing MCP server found. Starting new server on port ${discovery.port}`);
+        }
+    }
+    catch (error) {
+        log(`Port discovery failed: ${error}`);
+        log(`Attempting to use preferred port ${preferredPort}`);
+        discovery = { port: preferredPort, isExistingServer: false };
+    }
+    // Check if build is needed (skip if we're already in a build process)
+    if (!process.env.npm_lifecycle_event && checkBuildNeeded()) {
+        runBuild();
+    }
+    // Start the HTTP server on the discovered port
+    startServer(discovery.port);
+}
+// Handle unhandled errors
+process.on('uncaughtException', error => {
+    log(`Uncaught exception: ${error}`);
+    process.exit(1);
+});
+process.on('unhandledRejection', error => {
+    log(`Unhandled rejection: ${error}`);
+    process.exit(1);
+});
+main().catch(error => {
+    log(`Launcher error: ${error}`);
+    process.exit(1);
+});
+//# sourceMappingURL=launcher.js.map

package/dist/launcher.js.map

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

package/dist/mcp-server.d.ts

@@ -0,0 +1,5 @@
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { z } from 'zod';
+import { configSchema } from './types.js';
+export declare function setupMCPServer(server: Server, config: z.infer<typeof configSchema>): void;
+//# sourceMappingURL=mcp-server.d.ts.map

package/dist/mcp-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-server.d.ts","sourceRoot":"","sources":["../src/mcp-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2CAA2C,CAAC;AAEnE,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAY1C,wBAAgB,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,QAiVlF"}

package/dist/mcp-server.js

@@ -0,0 +1,329 @@
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { handleAskPerplexity, handleResearchPerplexity } from './tools/query.js';
+import { handleChatPerplexity, handleListChats, handleReadChat, handleStorageStats, } from './tools/chat.js';
+import { handleAsyncPerplexity, handleCheckAsync, handleListAsyncJobs } from './tools/async.js';
+import { handleListProjects, handleDeleteProject } from './tools/projects.js';
+import { getModelSummary } from './models.js';
+export function setupMCPServer(server, config) {
+    // List available tools
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: [
+            {
+                name: 'ask_perplexity',
+                description: 'Query Perplexity with automatic model selection based on complexity.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: { type: 'string', description: 'Your question or prompt' },
+                        project_name: {
+                            type: 'string',
+                            description: 'Project name for organizing conversations (auto-detected if not provided)',
+                        },
+                        model: {
+                            type: 'string',
+                            enum: [
+                                'sonar',
+                                'sonar-pro',
+                                'sonar-reasoning',
+                                'sonar-reasoning-pro',
+                                'sonar-deep-research',
+                            ],
+                            description: 'Override default model',
+                        },
+                        temperature: {
+                            type: 'number',
+                            minimum: 0,
+                            maximum: 1,
+                            description: '0.0-1.0, default 0.2',
+                        },
+                        max_tokens: { type: 'number', minimum: 1, description: 'Maximum response length' },
+                        search_domain_filter: {
+                            type: 'array',
+                            items: { type: 'string' },
+                            description: 'Limit search to specific domains',
+                        },
+                        return_images: { type: 'boolean', description: 'Include images in response' },
+                        return_related_questions: {
+                            type: 'boolean',
+                            description: 'Include related questions',
+                        },
+                        save_report: {
+                            type: 'boolean',
+                            description: 'Save response as a report to project directory',
+                        },
+                    },
+                    required: ['query'],
+                },
+            },
+            {
+                name: 'research_perplexity',
+                description: 'Conduct comprehensive research using sonar-deep-research model.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        topic: { type: 'string', description: 'Research topic or question' },
+                        project_name: {
+                            type: 'string',
+                            description: 'Project name for organizing research reports (auto-detected if not provided)',
+                        },
+                        save_report: { type: 'boolean', description: 'Save report to project directory' },
+                        model: {
+                            type: 'string',
+                            enum: [
+                                'sonar',
+                                'sonar-pro',
+                                'sonar-reasoning',
+                                'sonar-reasoning-pro',
+                                'sonar-deep-research',
+                            ],
+                            description: 'Override default model (defaults to sonar-deep-research)',
+                        },
+                        max_tokens: { type: 'number', minimum: 1, description: 'Maximum response length' },
+                    },
+                    required: ['topic'],
+                },
+            },
+            {
+                name: 'chat_perplexity',
+                description: 'Maintain conversations with Perplexity stored in project directory.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        message: { type: 'string', description: 'Your message' },
+                        project_name: {
+                            type: 'string',
+                            description: 'Project name for organizing conversations (auto-detected if not provided)',
+                        },
+                        chat_id: { type: 'string', description: 'Continue existing conversation' },
+                        title: { type: 'string', description: 'Required for new chat - conversation title' },
+                        model: {
+                            type: 'string',
+                            enum: [
+                                'sonar',
+                                'sonar-pro',
+                                'sonar-reasoning',
+                                'sonar-reasoning-pro',
+                                'sonar-deep-research',
+                            ],
+                            description: 'Override default model',
+                        },
+                        temperature: {
+                            type: 'number',
+                            minimum: 0,
+                            maximum: 1,
+                            description: '0.0-1.0, default 0.2',
+                        },
+                        max_tokens: { type: 'number', minimum: 1, description: 'Maximum response length' },
+                        save_report: { type: 'boolean', description: 'Save conversation to project directory' },
+                    },
+                    required: ['message'],
+                },
+            },
+            {
+                name: 'async_perplexity',
+                description: 'Create async jobs for complex queries that may take longer to process.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: { type: 'string', description: 'Your question or prompt' },
+                        model: {
+                            type: 'string',
+                            enum: [
+                                'sonar',
+                                'sonar-pro',
+                                'sonar-reasoning',
+                                'sonar-reasoning-pro',
+                                'sonar-deep-research',
+                            ],
+                            description: 'Override default model',
+                        },
+                        temperature: {
+                            type: 'number',
+                            minimum: 0,
+                            maximum: 1,
+                            description: '0.0-1.0, default 0.2',
+                        },
+                        max_tokens: { type: 'number', minimum: 1, description: 'Maximum response length' },
+                    },
+                    required: ['query'],
+                },
+            },
+            {
+                name: 'check_async_perplexity',
+                description: 'Check status and retrieve results of async Perplexity jobs.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        job_id: { type: 'string', description: 'Async job identifier' },
+                    },
+                    required: ['job_id'],
+                },
+            },
+            {
+                name: 'list_async_jobs',
+                description: 'List all async Perplexity jobs with status and timing information.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        project_name: {
+                            type: 'string',
+                            description: 'Project name (auto-detected if not provided)',
+                        },
+                        limit: {
+                            type: 'number',
+                            minimum: 1,
+                            maximum: 100,
+                            description: 'Maximum number of jobs to return (default: 20)',
+                        },
+                        next_token: { type: 'string', description: 'Token for pagination' },
+                    },
+                },
+            },
+            {
+                name: 'list_chats_perplexity',
+                description: 'List all conversations stored in the current project.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        project_name: {
+                            type: 'string',
+                            description: 'Project name (auto-detected if not provided)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'read_chat_perplexity',
+                description: 'Retrieve complete conversation history from project storage.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        chat_id: { type: 'string', description: 'Conversation identifier' },
+                    },
+                    required: ['chat_id'],
+                },
+            },
+            {
+                name: 'storage_stats_perplexity',
+                description: "Get storage statistics for the current project's Perplexity data.",
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        project_name: {
+                            type: 'string',
+                            description: 'Project name (auto-detected if not provided)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'list_projects_perplexity',
+                description: 'List all existing projects with optional detailed statistics.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        detailed: {
+                            type: 'boolean',
+                            description: 'Include detailed statistics for each project',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'delete_project_perplexity',
+                description: 'Safely delete a project and all its data.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        project_name: {
+                            type: 'string',
+                            description: 'Name of the project to delete (all data will be permanently removed)',
+                        },
+                        confirm: {
+                            type: 'boolean',
+                            description: 'Confirmation that you want to permanently delete all project data',
+                        },
+                    },
+                    required: ['project_name', 'confirm'],
+                },
+            },
+            {
+                name: 'model_info_perplexity',
+                description: 'Get detailed information about available Perplexity models.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+        ],
+    }));
+    // Handle tool execution
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            switch (name) {
+                case 'ask_perplexity': {
+                    const result = await handleAskPerplexity(args, config);
+                    // handleAskPerplexity returns MCP format, pass through
+                    return result;
+                }
+                case 'research_perplexity': {
+                    const result = await handleResearchPerplexity(args, config);
+                    // research_perplexity returns raw data, need to wrap in MCP format
+                    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                }
+                case 'chat_perplexity': {
+                    const result = await handleChatPerplexity(args, config);
+                    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                }
+                case 'async_perplexity': {
+                    const result = await handleAsyncPerplexity(args, config);
+                    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                }
+                case 'check_async_perplexity': {
+                    const result = await handleCheckAsync(args, config);
+                    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                }
+                case 'list_async_jobs': {
+                    const { limit, next_token } = args;
+                    const result = await handleListAsyncJobs(config, limit, next_token);
+                    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                }
+                case 'list_chats_perplexity': {
+                    const result = await handleListChats(config);
+                    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                }
+                case 'read_chat_perplexity': {
+                    const result = await handleReadChat(args, config);
+                    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                }
+                case 'storage_stats_perplexity': {
+                    const result = await handleStorageStats(config);
+                    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                }
+                case 'list_projects_perplexity': {
+                    const result = await handleListProjects(args, config);
+                    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                }
+                case 'delete_project_perplexity': {
+                    const result = await handleDeleteProject(args, config);
+                    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                }
+                case 'model_info_perplexity': {
+                    const result = getModelSummary();
+                    return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }] };
+                }
+                default:
+                    throw new Error(`Unknown tool: ${name}`);
+            }
+        }
+        catch (error) {
+            const errorMessage = error instanceof Error ? error.message : String(error);
+            return {
+                content: [{ type: 'text', text: JSON.stringify({ error: errorMessage }, null, 2) }],
+                isError: true,
+            };
+        }
+    });
+}
+//# sourceMappingURL=mcp-server.js.map

package/dist/mcp-server.js.map

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

package/dist/models.d.ts

@@ -0,0 +1,45 @@
+import type { ModelRegistry, PerplexityModel, ModelCapability } from './types.js';
+export declare const MODEL_REGISTRY: ModelRegistry;
+/**
+ * Intelligent model selection based on query characteristics
+ * Analyzes the query content and selects the most appropriate model
+ */
+export declare function selectOptimalModel(query: string, explicitModel?: PerplexityModel, defaultModel?: PerplexityModel): PerplexityModel;
+/**
+ * Validates if a model name is supported
+ */
+export declare function isValidModel(model: string): model is PerplexityModel;
+/**
+ * Gets model information by name
+ */
+export declare function getModelInfo(model: PerplexityModel): ModelCapability;
+/**
+ * Gets model capabilities in boolean format for compatibility
+ */
+export declare function getModelCapabilities(model: string): {
+    search: boolean;
+    reasoning: boolean;
+    realTime: boolean;
+    research: boolean;
+} | undefined;
+/**
+ * Suggests a fallback model based on the original model and context
+ */
+export declare function suggestFallbackModel(originalModel: PerplexityModel, errorType?: string): PerplexityModel;
+/**
+ * Gets all models of a specific type
+ */
+export declare function getModelsByType(type: 'search' | 'reasoning' | 'research'): PerplexityModel[];
+/**
+ * Gets model recommendations based on use case
+ */
+export declare function getModelRecommendations(useCase: string): PerplexityModel[];
+/**
+ * Formats model information for display
+ */
+export declare function formatModelInfo(model: PerplexityModel): string;
+/**
+ * Gets a summary of all available models
+ */
+export declare function getModelSummary(): string;
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,eAAe,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAGlF,eAAO,MAAM,cAAc,EAAE,aAqG5B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,MAAM,EACb,aAAa,CAAC,EAAE,eAAe,EAC/B,YAAY,GAAE,eAAuC,GACpD,eAAe,CAyGjB;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,IAAI,eAAe,CAEpE;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,eAAe,GAAG,eAAe,CAEpE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,MAAM,GACZ;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,SAAS,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAAG,SAAS,CAO3F;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,aAAa,EAAE,eAAe,EAC9B,SAAS,CAAC,EAAE,MAAM,GACjB,eAAe,CA4BjB;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,QAAQ,GAAG,WAAW,GAAG,UAAU,GAAG,eAAe,EAAE,CAI5F;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,MAAM,GAAG,eAAe,EAAE,CAW1E;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE,eAAe,GAAG,MAAM,CAG9D;AAED;;GAEG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAMxC"}