@perplexity-ai/mcp-server 0.4.1 → 0.5.1

package/.claude-plugin/marketplace.json

@@ -6,14 +6,14 @@
   },
   "metadata": {
     "description": "Official Perplexity AI plugin providing real-time web search, reasoning, and research capabilities",
-    "version": "0.4.1"
+    "version": "0.5.1"
   },
   "plugins": [
     {
       "name": "perplexity",
       "source": "./",
       "description": "Real-time web search, reasoning, and research through Perplexity's API",
-      "version": "0.4.1",
+      "version": "0.5.1",
       "author": {
         "name": "Perplexity AI",
         "email": "api@perplexity.ai"

package/README.md

@@ -8,8 +8,6 @@
 
 The official MCP server implementation for the Perplexity API Platform, providing AI assistants with real-time web search, reasoning, and research capabilities through Sonar models and the Search API.
 
-Please refer to the official [DeepWiki page](https://deepwiki.com/ppl-ai/modelcontextprotocol) for assistance with implementation.
-
 ## Available Tools
 
 ### **perplexity_search**
@@ -40,9 +38,15 @@ Advanced reasoning and problem-solving using the `sonar-reasoning-pro` model. Pe
 
 #### Option 1: Install via Plugin (Recommended)
 
-The easiest way to get started with Perplexity in Claude Code:
-
+The easiest way to get started with Perplexity in Claude Code, set your API key:
 ```bash
+export PERPLEXITY_API_KEY="your_key_here"
+```
+Then:
+```bash
+# Open Claude Code
+claude
+
 # Add the Perplexity marketplace
 /plugin marketplace add perplexityai/modelcontextprotocol
 
@@ -50,11 +54,6 @@ The easiest way to get started with Perplexity in Claude Code:
 /plugin install perplexity
 ```
 
-Then set your API key:
-```bash
-export PERPLEXITY_API_KEY="your_key_here"
-```
-
 #### Option 2: Manual Configuration
 
 Run in your terminal:
@@ -169,6 +168,40 @@ If you'd rather use the standard variables, we support `HTTPS_PROXY` and `HTTP_P
 > The server checks proxy settings in this order: `PERPLEXITY_PROXY` → `HTTPS_PROXY` → `HTTP_PROXY`. If none are set, it connects directly to the internet.
 > URLs must include `https://`. Typical ports are `8080`, `3128`, and `80`.
 
+
+### HTTP Server Deployment
+
+For cloud or shared deployments, you can run the server in HTTP mode:
+
+#### Environment Variables
+
+The HTTP server supports these configuration options:
+
+- **`PORT`** - HTTP server port (default: `8080`)
+- **`BIND_ADDRESS`** - Network interface to bind to (default: `127.0.0.1` for local, use `0.0.0.0` for hosted)
+- **`ALLOWED_ORIGINS`** - Comma-separated list of allowed CORS origins (default: `http://localhost:3000,http://127.0.0.1:3000`, use `*` for public service)
+- **`PERPLEXITY_API_KEY`** - Your Perplexity API key (required)
+
+#### Using Docker
+
+```bash
+docker build -t perplexity-mcp-server .
+docker run -p 8080:8080 -e PERPLEXITY_API_KEY=your_key_here perplexity-mcp-server
+```
+
+The server will be accessible at `http://localhost:8080/mcp`
+
+#### Using Node.js Directly
+
+```bash
+npm install
+npm run build
+npm run start:http
+```
+
+Connect your MCP client to: `http://localhost:8080/mcp`
+
+
 ## Troubleshooting
 
 - **API Key Issues**: Ensure `PERPLEXITY_API_KEY` is set correctly

package/dist/http.js

@@ -0,0 +1,81 @@
+#!/usr/bin/env node
+import express from "express";
+import cors from "cors";
+import { StreamableHTTPServerTransport } from "@modelcontextprotocol/sdk/server/streamableHttp.js";
+import { createPerplexityServer } from "./server.js";
+// Check for required API key
+const PERPLEXITY_API_KEY = process.env.PERPLEXITY_API_KEY;
+if (!PERPLEXITY_API_KEY) {
+    console.error("Error: PERPLEXITY_API_KEY environment variable is required");
+    process.exit(1);
+}
+const app = express();
+const PORT = parseInt(process.env.PORT || "8080", 10);
+const BIND_ADDRESS = process.env.BIND_ADDRESS || "127.0.0.1";
+const ALLOWED_ORIGINS = process.env.ALLOWED_ORIGINS?.split(",") || [
+    "http://localhost:3000",
+    "http://127.0.0.1:3000",
+];
+// CORS configuration for browser-based MCP clients
+app.use(cors({
+    origin: (origin, callback) => {
+        if (!origin)
+            return callback(null, true);
+        if (ALLOWED_ORIGINS.includes("*")) {
+            return callback(null, true);
+        }
+        if (ALLOWED_ORIGINS.includes(origin)) {
+            callback(null, true);
+        }
+        else {
+            callback(new Error(`Origin ${origin} not allowed by CORS`));
+        }
+    },
+    exposedHeaders: ["Mcp-Session-Id", "mcp-protocol-version"],
+    allowedHeaders: ["Content-Type", "mcp-session-id"],
+}));
+app.use(express.json());
+const mcpServer = createPerplexityServer();
+/**
+ * POST: client-to-server messages (requests, responses, notifications)
+ * GET: SSE stream for server-to-client messages (notifications, requests)
+ */
+app.all("/mcp", async (req, res) => {
+    try {
+        const transport = new StreamableHTTPServerTransport({
+            sessionIdGenerator: undefined,
+            enableJsonResponse: true,
+        });
+        res.on('close', () => {
+            transport.close();
+        });
+        await mcpServer.connect(transport);
+        await transport.handleRequest(req, res, req.body);
+    }
+    catch (error) {
+        console.error("Error handling MCP request:", error);
+        if (!res.headersSent) {
+            res.status(500).json({
+                jsonrpc: "2.0",
+                error: { code: -32603, message: "Internal server error" },
+                id: null,
+            });
+        }
+    }
+});
+/**
+ * Health check endpoint
+ */
+app.get("/health", (req, res) => {
+    res.json({ status: "ok", service: "perplexity-mcp-server" });
+});
+/**
+ * Start the HTTP server
+ */
+app.listen(PORT, BIND_ADDRESS, () => {
+    console.log(`Perplexity MCP Server listening on http://${BIND_ADDRESS}:${PORT}/mcp`);
+    console.log(`Allowed origins: ${ALLOWED_ORIGINS.join(", ")}`);
+}).on("error", (error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});