mcp-perplexity-pro 1.1.0

package/dist/stdio-server.js

@@ -0,0 +1,396 @@
+#!/usr/bin/env node
+/**
+ * Stdio-only entry point for Claude Desktop and other stdio-based MCP clients
+ * This bypasses the HTTP launcher and starts directly with stdio transport
+ */
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { configSchema } from './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';
+// Smart project root detection for MCP servers
+function detectProjectRoot() {
+    const cwd = process.cwd();
+    // If we're running from filesystem root or system directories,
+    // use the user's home directory instead
+    if (cwd === '/' ||
+        cwd.startsWith('/usr/') ||
+        cwd.startsWith('/opt/') ||
+        cwd.startsWith('/var/')) {
+        return process.env.HOME || process.env.USERPROFILE || cwd;
+    }
+    // For other cases, use the current working directory
+    return cwd;
+}
+// Load configuration - try multiple sources for API key
+const apiKey = process.env.PERPLEXITY_API_KEY || process.env.API_KEY || process.env.PERPLEXITY_API_TOKEN || '';
+const config = {
+    api_key: apiKey,
+    default_model: process.env.DEFAULT_MODEL || 'sonar-reasoning-pro',
+    project_root: process.env.PROJECT_ROOT || detectProjectRoot(),
+    storage_path: process.env.STORAGE_PATH || '.perplexity',
+    session_id: process.env.SESSION_ID,
+};
+// Validate configuration
+const validatedConfig = configSchema.parse(config);
+// Create MCP server
+const server = new Server({
+    name: 'mcp-perplexity-pro',
+    version: '1.0.0',
+}, {
+    capabilities: {
+        tools: {},
+        progress: true,
+    },
+});
+// Register tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+    return {
+        tools: [
+            {
+                name: 'ask_perplexity',
+                description: 'Query Perplexity AI with intelligent model selection for your questions.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        query: { type: 'string', description: 'Your question or prompt' },
+                        project_name: {
+                            type: 'string',
+                            description: 'Project name for organizing data (auto-detected if not provided)',
+                        },
+                        model: {
+                            type: 'string',
+                            enum: [
+                                'sonar',
+                                'sonar-pro',
+                                'sonar-reasoning',
+                                'sonar-reasoning-pro',
+                                'sonar-deep-research',
+                            ],
+                            description: 'Override default model selection',
+                        },
+                        temperature: {
+                            type: 'number',
+                            minimum: 0,
+                            maximum: 1,
+                            description: 'Sampling temperature (0.0-1.0, default: 0.2)',
+                        },
+                        max_tokens: { type: 'number', minimum: 1, description: 'Maximum response length' },
+                        save_report: { type: 'boolean', description: 'Save response to project directory' },
+                    },
+                    required: ['query'],
+                },
+            },
+            {
+                name: 'research_perplexity',
+                description: 'Conduct comprehensive research with Perplexity and save detailed reports.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        topic: { type: 'string', description: 'Research topic or question' },
+                        project_name: {
+                            type: 'string',
+                            description: 'Project name for organizing reports (auto-detected if not provided)',
+                        },
+                        model: {
+                            type: 'string',
+                            enum: [
+                                'sonar',
+                                'sonar-pro',
+                                'sonar-reasoning',
+                                'sonar-reasoning-pro',
+                                'sonar-deep-research',
+                            ],
+                            description: 'Defaults to sonar-deep-research for comprehensive research',
+                        },
+                        save_report: { type: 'boolean', description: 'Save research report (default: true)' },
+                    },
+                    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',
+                        },
+                        project_name: {
+                            type: 'string',
+                            description: 'Project name for organizing data (auto-detected if not provided)',
+                        },
+                    },
+                    required: ['query'],
+                },
+            },
+            {
+                name: 'check_async_perplexity',
+                description: 'Check the status of an async job and retrieve results if complete.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        job_id: { type: 'string', description: 'Job ID returned from async_perplexity' },
+                    },
+                    required: ['job_id'],
+                },
+            },
+            {
+                name: 'list_async_jobs',
+                description: 'List all async jobs and their current status.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        limit: {
+                            type: 'number',
+                            minimum: 1,
+                            maximum: 50,
+                            description: 'Number of jobs to return',
+                        },
+                        project_name: {
+                            type: 'string',
+                            description: 'Filter by project (auto-detected if not provided)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'list_chats_perplexity',
+                description: 'List all stored conversations in your project.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        project_name: {
+                            type: 'string',
+                            description: 'Project name to list chats from (auto-detected if not provided)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'read_chat_perplexity',
+                description: 'Read the full conversation history from a stored chat.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        chat_id: { type: 'string', description: 'Chat ID to retrieve' },
+                        project_name: {
+                            type: 'string',
+                            description: 'Project name (auto-detected if not provided)',
+                        },
+                    },
+                    required: ['chat_id'],
+                },
+            },
+            {
+                name: 'storage_stats_perplexity',
+                description: 'Get storage usage statistics for your projects.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        project_name: {
+                            type: 'string',
+                            description: 'Specific project to analyze (all projects if not provided)',
+                        },
+                    },
+                },
+            },
+            {
+                name: 'list_projects_perplexity',
+                description: 'List all projects with their conversation and report counts.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+            {
+                name: 'delete_project_perplexity',
+                description: 'Safely delete a project and all its data after confirmation.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {
+                        project_name: { type: 'string', description: 'Project name to delete' },
+                        confirm: {
+                            type: 'boolean',
+                            description: 'Must be true to confirm deletion - this action cannot be undone',
+                        },
+                    },
+                    required: ['project_name', 'confirm'],
+                },
+            },
+            {
+                name: 'model_info_perplexity',
+                description: 'Get information about available Perplexity models and selection guidance.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+        ],
+    };
+});
+// Register tool call handler
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+    const { name, arguments: args } = request.params;
+    try {
+        switch (name) {
+            case 'ask_perplexity': {
+                const result = await handleAskPerplexity(args, validatedConfig);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'research_perplexity': {
+                const result = await handleResearchPerplexity(args, validatedConfig);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'chat_perplexity': {
+                const result = await handleChatPerplexity(args, validatedConfig);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'list_chats_perplexity': {
+                const result = await handleListChats(validatedConfig);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'read_chat_perplexity': {
+                const result = await handleReadChat(args, validatedConfig);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'async_perplexity': {
+                const result = await handleAsyncPerplexity(args, validatedConfig);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'check_async_perplexity': {
+                const result = await handleCheckAsync(args, validatedConfig);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'list_async_jobs': {
+                const jobArgs = args;
+                const result = await handleListAsyncJobs(validatedConfig, jobArgs?.limit, jobArgs?.next_token);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'storage_stats_perplexity': {
+                const result = await handleStorageStats(validatedConfig);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'list_projects_perplexity': {
+                const result = await handleListProjects(args, validatedConfig);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'delete_project_perplexity': {
+                const result = await handleDeleteProject(args, validatedConfig);
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            case 'model_info_perplexity': {
+                const modelInfo = {
+                    available_models: getModelSummary(),
+                    default_model: validatedConfig.default_model,
+                    automatic_selection: 'Enabled - models selected based on query complexity and requirements',
+                    override_capability: 'All tools accept optional "model" parameter to override automatic selection',
+                    selection_factors: [
+                        'Query complexity and length',
+                        'Keywords indicating specific needs (research, analysis, etc.)',
+                        'Task type (facts vs reasoning vs research)',
+                        'Performance vs cost trade-offs',
+                    ],
+                };
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(modelInfo, null, 2) }],
+                };
+            }
+            default:
+                throw new Error(`Unknown tool: ${name}`);
+        }
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// Start the server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch(error => {
+    console.error('Failed to start stdio MCP server:', error);
+    process.exit(1);
+});
+//# sourceMappingURL=stdio-server.js.map

package/dist/stdio-server.js.map

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

package/dist/storage.d.ts

@@ -0,0 +1,65 @@
+import type { Config, Conversation, ChatMetadata, Message, PerplexityModel, ErrorResponse } from './types.js';
+export declare class StorageError extends Error {
+    code?: string | undefined;
+    constructor(message: string, code?: string | undefined);
+}
+export declare class StorageManager {
+    private projectRoot;
+    private storagePath;
+    private sessionId?;
+    constructor(config: Config);
+    /**
+     * Ensures the storage directory exists
+     */
+    private ensureStorageDirectory;
+    /**
+     * Gets the full path for a conversation file
+     */
+    private getConversationPath;
+    /**
+     * Gets the path for a research report
+     */
+    private getReportPath;
+    /**
+     * Executes a function with file locking for thread safety
+     */
+    private withLock;
+    /**
+     * Creates a new conversation
+     */
+    createConversation(title: string, model: PerplexityModel, initialMessage?: Message): Promise<string>;
+    /**
+     * Adds a message to an existing conversation
+     */
+    addMessage(chatId: string, message: Message): Promise<void>;
+    /**
+     * Retrieves a conversation by ID
+     */
+    getConversation(chatId: string): Promise<Conversation>;
+    /**
+     * Lists all conversations in the current project
+     */
+    listConversations(): Promise<ChatMetadata[]>;
+    /**
+     * Deletes a conversation
+     */
+    deleteConversation(chatId: string): Promise<void>;
+    /**
+     * Saves a research report to the project directory
+     */
+    saveReport(content: string, title: string): Promise<string>;
+    /**
+     * Gets storage statistics for the current project
+     */
+    getStorageStats(): Promise<{
+        total_conversations: number;
+        total_messages: number;
+        storage_size_bytes: number;
+        last_activity: string | null;
+    }>;
+    /**
+     * Handles storage errors and creates structured error responses
+     */
+    static handleError(error: unknown): ErrorResponse;
+}
+//# sourceMappingURL=storage.d.ts.map

package/dist/storage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"storage.d.ts","sourceRoot":"","sources":["../src/storage.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EACV,MAAM,EACN,YAAY,EACZ,YAAY,EACZ,OAAO,EACP,eAAe,EACf,aAAa,EACd,MAAM,YAAY,CAAC;AAEpB,qBAAa,YAAa,SAAQ,KAAK;IAG5B,IAAI,CAAC,EAAE,MAAM;gBADpB,OAAO,EAAE,MAAM,EACR,IAAI,CAAC,EAAE,MAAM,YAAA;CAKvB;AAED,qBAAa,cAAc;IACzB,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,SAAS,CAAC,CAAS;gBAEf,MAAM,EAAE,MAAM;IAQ1B;;OAEG;YACW,sBAAsB;IAWpC;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAM3B;;OAEG;IACH,OAAO,CAAC,aAAa;IAOrB;;OAEG;YACW,QAAQ;IAsCtB;;OAEG;IACG,kBAAkB,CACtB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,eAAe,EACtB,cAAc,CAAC,EAAE,OAAO,GACvB,OAAO,CAAC,MAAM,CAAC;IA2BlB;;OAEG;IACG,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBjE;;OAEG;IACG,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAc5D;;OAEG;IACG,iBAAiB,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAyClD;;OAEG;IACG,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAavD;;OAEG;IACG,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IA0BjE;;OAEG;IACG,eAAe,IAAI,OAAO,CAAC;QAC/B,mBAAmB,EAAE,MAAM,CAAC;QAC5B,cAAc,EAAE,MAAM,CAAC;QACvB,kBAAkB,EAAE,MAAM,CAAC;QAC3B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;KAC9B,CAAC;IAwCF;;OAEG;IACH,MAAM,CAAC,WAAW,CAAC,KAAK,EAAE,OAAO,GAAG,aAAa;CA4DlD"}