mcp-perplexity-pro 1.1.0

package/dist/sse-index.js

@@ -0,0 +1,38 @@
+#!/usr/bin/env node
+import { createSSEServer } from './sse-server.js';
+import { configSchema } from './types.js';
+// Default port
+let PORT = 8124;
+// Parse command-line arguments for --port=XXXX
+for (let i = 2; i < process.argv.length; i++) {
+    const arg = process.argv[i];
+    if (arg.startsWith('--port=')) {
+        const value = parseInt(arg.split('=')[1], 10);
+        if (!isNaN(value)) {
+            PORT = value;
+        }
+        else {
+            console.error('Invalid value for --port');
+            process.exit(1);
+        }
+    }
+}
+// Load configuration
+const config = {
+    api_key: process.env.PERPLEXITY_API_KEY || '',
+    default_model: 'sonar-reasoning-pro',
+    project_root: process.cwd(),
+    storage_path: '.perplexity',
+};
+// Validate configuration
+const validatedConfig = configSchema.parse(config);
+const app = createSSEServer(validatedConfig);
+app.listen(PORT, () => {
+    console.log(`MCP Perplexity SSE Server listening on port ${PORT}`);
+    console.log(`Claude Code can connect using: claude mcp add --transport sse perplexity-sse http://localhost:${PORT}/sse`);
+});
+process.on('SIGINT', () => {
+    console.log('Shutting down SSE server...');
+    process.exit(0);
+});
+//# sourceMappingURL=sse-index.js.map

package/dist/sse-index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sse-index.js","sourceRoot":"","sources":["../src/sse-index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,eAAe;AACf,IAAI,IAAI,GAAG,IAAI,CAAC;AAEhB,+CAA+C;AAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;IAC7C,MAAM,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC5B,IAAI,GAAG,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;QAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAC9C,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;YAClB,IAAI,GAAG,KAAK,CAAC;QACf,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,0BAA0B,CAAC,CAAC;YAC1C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;IACH,CAAC;AACH,CAAC;AAED,qBAAqB;AACrB,MAAM,MAAM,GAAG;IACb,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,EAAE;IAC7C,aAAa,EAAE,qBAAqB;IACpC,YAAY,EAAE,OAAO,CAAC,GAAG,EAAE;IAC3B,YAAY,EAAE,aAAa;CAC5B,CAAC;AAEF,yBAAyB;AACzB,MAAM,eAAe,GAAG,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;AAEnD,MAAM,GAAG,GAAG,eAAe,CAAC,eAAe,CAAC,CAAC;AAE7C,GAAG,CAAC,MAAM,CAAC,IAAI,EAAE,GAAG,EAAE;IACpB,OAAO,CAAC,GAAG,CAAC,+CAA+C,IAAI,EAAE,CAAC,CAAC;IACnE,OAAO,CAAC,GAAG,CACT,iGAAiG,IAAI,MAAM,CAC5G,CAAC;AACJ,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;IAC3C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/sse-server.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+import { configSchema } from './types.js';
+export declare function createSSEServer(config: z.infer<typeof configSchema>): import("express-serve-static-core").Express;
+//# sourceMappingURL=sse-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sse-server.d.ts","sourceRoot":"","sources":["../src/sse-server.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAI1C,wBAAgB,eAAe,CAAC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,+CA8NnE"}

package/dist/sse-server.js

@@ -0,0 +1,208 @@
+import express from 'express';
+import { Server } from '@modelcontextprotocol/sdk/server/index.js';
+import { SSEServerTransport } from '@modelcontextprotocol/sdk/server/sse.js';
+import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprotocol/sdk/types.js';
+import { handleAskPerplexity, handleResearchPerplexity } from './tools/query.js';
+import { getModelSummary } from './models.js';
+export function createSSEServer(config) {
+    const server = new Server({
+        name: 'mcp-perplexity-pro',
+        version: '1.0.0',
+    }, {
+        capabilities: {
+            tools: {},
+        },
+    });
+    // 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: 'model_info_perplexity',
+                description: 'Get detailed information about available Perplexity models.',
+                inputSchema: {
+                    type: 'object',
+                    properties: {},
+                },
+            },
+        ],
+    }));
+    // Handle tool calls
+    server.setRequestHandler(CallToolRequestSchema, async (request) => {
+        const { name, arguments: args } = request.params;
+        try {
+            switch (name) {
+                case 'ask_perplexity': {
+                    const result = await handleAskPerplexity(args, config);
+                    return result;
+                }
+                case 'research_perplexity': {
+                    const result = await handleResearchPerplexity(args, config);
+                    return {
+                        content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                    };
+                }
+                case 'model_info_perplexity': {
+                    const modelInfo = {
+                        available_models: getModelSummary(),
+                        default_model: config.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,
+            };
+        }
+    });
+    const app = express();
+    app.use(express.json());
+    // Add logging middleware
+    app.use((req, res, next) => {
+        console.log(`${new Date().toISOString()} - ${req.method} ${req.url}`);
+        next();
+    });
+    const transportMap = new Map();
+    // OAuth endpoints for Claude Code compatibility
+    app.post('/oauth/register', (req, res) => {
+        console.log('OAuth register request received:', req.body);
+        // Mock OAuth dynamic client registration
+        res.json({
+            client_id: 'perplexity-sse-client',
+            client_secret: 'mock-secret',
+            authorization_endpoint: `http://localhost:8124/oauth/authorize`,
+            token_endpoint: `http://localhost:8124/oauth/token`,
+        });
+    });
+    app.get('/oauth/authorize', (req, res) => {
+        // Mock OAuth authorization - auto-approve for local development
+        const { redirect_uri, state } = req.query;
+        res.redirect(`${redirect_uri}?code=mock-auth-code&state=${state}`);
+    });
+    app.post('/oauth/token', (req, res) => {
+        // Mock OAuth token exchange
+        res.json({
+            access_token: 'mock-access-token',
+            token_type: 'Bearer',
+            expires_in: 3600,
+        });
+    });
+    // SSE endpoint for real-time streaming
+    app.get('/sse', async (req, res) => {
+        const transport = new SSEServerTransport('/messages', res);
+        transportMap.set(transport.sessionId, transport);
+        await server.connect(transport);
+    });
+    // Messages endpoint for handling POST requests
+    app.post('/messages', (req, res) => {
+        const sessionId = req.query.sessionId;
+        if (!sessionId) {
+            console.error('Message received without sessionId');
+            res.status(400).json({ error: 'sessionId is required' });
+            return;
+        }
+        const transport = transportMap.get(sessionId);
+        if (transport) {
+            transport.handlePostMessage(req, res);
+        }
+        else {
+            res.status(404).json({ error: 'Session not found' });
+        }
+    });
+    return app;
+}
+//# sourceMappingURL=sse-server.js.map

package/dist/sse-server.js.map

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

package/dist/stdio-bridge.d.ts

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+/**
+ * Stdio-HTTP Bridge for Claude Desktop
+ *
+ * This bridge provides stdio compatibility for Claude Desktop while using
+ * our modern HTTP transport internally. Best of both worlds:
+ * - Claude Desktop gets the stdio interface it expects
+ * - We use HTTP transport internally (future-proof, not deprecated)
+ * - Single codebase supports both transports
+ */
+export declare class StdioHttpBridge {
+    private httpPort;
+    private httpServerProcess;
+    private server;
+    constructor();
+    start(): Promise<void>;
+    private startHttpServer;
+    private waitForHttpServer;
+    private setupMcpHandlers;
+}
+//# sourceMappingURL=stdio-bridge.d.ts.map

package/dist/stdio-bridge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-bridge.d.ts","sourceRoot":"","sources":["../src/stdio-bridge.ts"],"names":[],"mappings":";AACA;;;;;;;;GAQG;AAaH,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAQ;IACxB,OAAO,CAAC,iBAAiB,CAAa;IACtC,OAAO,CAAC,MAAM,CAAS;;IAoBjB,KAAK;YAYG,eAAe;YAqCf,iBAAiB;IAwB/B,OAAO,CAAC,gBAAgB;CA+CzB"}

package/dist/stdio-bridge.js

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+/**
+ * Stdio-HTTP Bridge for Claude Desktop
+ *
+ * This bridge provides stdio compatibility for Claude Desktop while using
+ * our modern HTTP transport internally. Best of both worlds:
+ * - Claude Desktop gets the stdio interface it expects
+ * - We use HTTP transport internally (future-proof, not deprecated)
+ * - Single codebase supports both transports
+ */
+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 { spawn } from 'child_process';
+import { join, dirname } from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = dirname(__filename);
+const projectRoot = dirname(__dirname);
+export class StdioHttpBridge {
+    httpPort = 8125;
+    httpServerProcess = null;
+    server;
+    constructor() {
+        // Create MCP server with stdio transport
+        this.server = new Server({
+            name: 'mcp-perplexity-pro',
+            version: '1.0.0',
+        }, {
+            capabilities: {
+                tools: {},
+                progress: true,
+            },
+        });
+        this.setupMcpHandlers();
+    }
+    async start() {
+        // Start HTTP server in background
+        await this.startHttpServer();
+        // Wait for HTTP server to be ready
+        await this.waitForHttpServer();
+        // Connect MCP server with stdio transport
+        const transport = new StdioServerTransport();
+        await this.server.connect(transport);
+    }
+    async startHttpServer() {
+        const launcherPath = join(projectRoot, 'dist', 'launcher.js');
+        this.httpServerProcess = spawn('node', [launcherPath, `--http-port=${this.httpPort}`], {
+            stdio: ['ignore', 'pipe', 'pipe'], // Capture output to prevent stdio pollution
+            env: { ...process.env },
+            cwd: projectRoot,
+        });
+        this.httpServerProcess.on('error', (error) => {
+            console.error(`HTTP server failed: ${error}`);
+            process.exit(1);
+        });
+        this.httpServerProcess.on('exit', (code) => {
+            if (code !== 0) {
+                console.error(`HTTP server exited with code ${code}`);
+                process.exit(code || 1);
+            }
+        });
+        // Graceful shutdown
+        process.on('SIGINT', () => {
+            if (this.httpServerProcess) {
+                this.httpServerProcess.kill('SIGINT');
+            }
+            process.exit(0);
+        });
+        process.on('SIGTERM', () => {
+            if (this.httpServerProcess) {
+                this.httpServerProcess.kill('SIGTERM');
+            }
+            process.exit(0);
+        });
+    }
+    async waitForHttpServer() {
+        const maxAttempts = 30; // 15 seconds
+        let attempts = 0;
+        while (attempts < maxAttempts) {
+            try {
+                const response = await fetch(`http://localhost:${this.httpPort}/health`);
+                if (response.ok) {
+                    const health = await response.json();
+                    if (health.status === 'healthy') {
+                        return; // Server is ready
+                    }
+                }
+            }
+            catch (error) {
+                // Server not ready yet
+            }
+            attempts++;
+            await new Promise(resolve => setTimeout(resolve, 500));
+        }
+        throw new Error('HTTP server failed to start within 15 seconds');
+    }
+    setupMcpHandlers() {
+        // List tools - proxy to HTTP server
+        this.server.setRequestHandler(ListToolsRequestSchema, async () => {
+            try {
+                const response = await fetch(`http://localhost:${this.httpPort}/api/tools`, {
+                    method: 'GET',
+                    headers: { 'Content-Type': 'application/json' },
+                });
+                if (!response.ok) {
+                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                }
+                const tools = await response.json();
+                return { tools };
+            }
+            catch (error) {
+                throw new Error(`Failed to list tools: ${error}`);
+            }
+        });
+        // Call tool - proxy to HTTP server
+        this.server.setRequestHandler(CallToolRequestSchema, async (request) => {
+            const { name, arguments: args } = request.params;
+            try {
+                const response = await fetch(`http://localhost:${this.httpPort}/api/tools/${name}`, {
+                    method: 'POST',
+                    headers: { 'Content-Type': 'application/json' },
+                    body: JSON.stringify(args),
+                });
+                if (!response.ok) {
+                    throw new Error(`HTTP ${response.status}: ${response.statusText}`);
+                }
+                const result = await response.json();
+                return {
+                    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
+                };
+            }
+            catch (error) {
+                return {
+                    content: [{ type: 'text', text: `Error: ${error}` }],
+                    isError: true,
+                };
+            }
+        });
+    }
+}
+// Start the bridge
+async function main() {
+    try {
+        const bridge = new StdioHttpBridge();
+        await bridge.start();
+    }
+    catch (error) {
+        console.error(`Bridge startup failed: ${error}`);
+        process.exit(1);
+    }
+}
+main().catch(error => {
+    console.error(`Bridge error: ${error}`);
+    process.exit(1);
+});
+//# sourceMappingURL=stdio-bridge.js.map

package/dist/stdio-bridge.js.map

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

package/dist/stdio-server.d.ts

@@ -0,0 +1,7 @@
+#!/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
+ */
+export {};
+//# sourceMappingURL=stdio-server.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stdio-server.d.ts","sourceRoot":"","sources":["../src/stdio-server.ts"],"names":[],"mappings":";AAEA;;;GAGG"}