MCP Perplexity Server

by lostmind008

325 downloads
Not rated
GitHub

About

An MCP server implementation that wraps the Perplexity API, supporting Ask and Search modes, designed for use with any MCP client.

Details

Author
lostmind008
Downloads
325
Categories
AI, API

- Supports both Ask and Search modes
- Simple configuration via environment variables
- Direct integration with MCP clients
- Runs via npx without local installation

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

  1. Download and install Highlight from highlightai.com/download
  2. Navigate to the plugins tab and select "Add Custom Plugin"
  3. Configure the plugin with the settings below
    Plugin Name MCP Perplexity Server
    Command (node, npx, python, etc.)

    Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.

  4. Enable "Start Automatically" if you want the plugin to start when Highlight launches

From the repository

Install by adding a configuration entry to your MCP client, specifying the command npx -y github:lostmind008/mcp-perplexity-server, and set the required environment variable PERPLEXITY_API_KEY plus optional MCP_SERVER_PORT and MCP_MODE. Invoke via the client using server names like perplexity-ask or perplexity-search.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

{
    "mcpServers": {
        "mcp perplexity server": {
            "perplexity-ask": {
                "command": "npx",
                "args": [
                    "-y",
                    "github:lostmind008/mcp-perplexity-server"
                ],
                "env": {
                    "PERPLEXITY_API_KEY": "your-api-key",
                    "MCP_SERVER_PORT": "3000",
                    "MCP_MODE": "ask"
                }
            },
            "perplexity-search": {
                "command": "npx",
                "args": [
                    "-y",
                    "github:lostmind008/mcp-perplexity-server"
                ],
                "env": {
                    "PERPLEXITY_API_KEY": "your-api-key",
                    "MCP_SERVER_PORT": "3001",
                    "MCP_MODE": "search"
                }
            }
        }
    }
}

McpServers

{
    "perplexity-ask": {
        "command": "npx",
        "args": [
            "-y",
            "github:lostmind008/mcp-perplexity-server"
        ],
        "env": {
            "PERPLEXITY_API_KEY": "your-api-key",
            "MCP_SERVER_PORT": "3000",
            "MCP_MODE": "ask"
        }
    },
    "perplexity-search": {
        "command": "npx",
        "args": [
            "-y",
            "github:lostmind008/mcp-perplexity-server"
        ],
        "env": {
            "PERPLEXITY_API_KEY": "your-api-key",
            "MCP_SERVER_PORT": "3001",
            "MCP_MODE": "search"
        }
    }
}

MCP Perplexity Server

A Model Context Protocol (MCP) server implementation for the Perplexity API.

Features

- Supports both Ask and Search modes
- Simple configuration via environment variables
- Direct integration with MCP clients

Installation

You can use this server directly from GitHub in your MCP configuration:

{
  "perplexity-ask": {
    "command": "npx",
    "args": [
      "-y",
      "github:lostmind008/mcp-perplexity-server"
    ],
    "env": {
      "PERPLEXITY_API_KEY": "your-api-key",
      "MCP_SERVER_PORT": "3000",
      "MCP_MODE": "ask"
    }
  },
  "perplexity-search": {
    "command": "npx",
    "args": [
      "-y",
      "github:lostmind008/mcp-perplexity-server"
    ],
    "env": {
      "PERPLEXITY_API_KEY": "your-api-key",
      "MCP_SERVER_PORT": "3001",
      "MCP_MODE": "search"
    }
  }
}

Environment Variables

- PERPLEXITY_API_KEY: Your Perplexity API key (required)
- MCP_SERVER_PORT: Port for the MCP server (default: 3000)
- MCP_MODE: Server mode - 'ask' or 'search' (default: 'ask')

Usage

Once configured, you can use this server with any MCP client by specifying the appropriate server name:

perplexity-ask "What is the capital of France?"
perplexity-search "Best programming languages 2025"

License

MIT

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.