Perplexity MCP Zerver

by wysh3

93 stars

639 downloads

Not rated

GitHub

About

MCP web search using perplexity without any API KEYS

Details

Author: wysh3
GitHub stars: 93
Downloads: 639
Categories: Search

- Intelligent web search and summarization without API limits
- Persistent conversation history stored in local SQLite
- Clean article extraction with native GitHub repository parsing
- Developer tooling: documentation retrieval, API discovery, code analysis
- Keyless operation using browser automation
- Optional Perplexity Pro login for better models and higher limits

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:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Perplexity MCP Zerver

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "perplexity mcp zerver": {
            "perplexity-mcp-zerver": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity mcp zerver": {
            "perplexity-mcp-zerver": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity mcp zerver": {
            "perplexity-mcp-zerver": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

{
    "mcpServers": {
        "perplexity mcp zerver": {
            "perplexity-mcp-zerver": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity mcp zerver": {
            "perplexity-mcp-zerver": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity mcp zerver": {
            "perplexity-mcp-zerver": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "perplexity mcp zerver": {
            "perplexity-mcp-zerver": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity mcp zerver": {
            "perplexity-mcp-zerver": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity mcp zerver": {
            "perplexity-mcp-zerver": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

{
    "mcpServers": {
        "perplexity mcp zerver": {
            "perplexity-mcp-zerver": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity mcp zerver": {
            "perplexity-mcp-zerver": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity mcp zerver": {
            "perplexity-mcp-zerver": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

{
    "mcpServers": {
        "perplexity mcp zerver": {
            "perplexity-mcp-zerver": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity mcp zerver": {
            "perplexity-mcp-zerver": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

JSON

{
    "mcpServers": {
        "perplexity mcp zerver": {
            "perplexity-mcp-zerver": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

From the repository

Install the Bun runtime and Node.js 18+, then clone the repository, run bun install and bun run build. Configure your MCP client by adding a server entry with "command": "bun" and "args": ["/absolute/path/to/build/main.js"]. Initiate research by sending commands through your MCP client, such as “Use perplexity to research quantum computing advancements.”

Claude Desktop / Cursor

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

{
    "mcpServers": {
        "perplexity mcp zerver": {
            "perplexity-mcp-zerver": {
                "command": "bun",
                "args": [
                    "run",
                    "build"
                ]
            }
        }
    }
}

McpServers

{
    "perplexity-mcp-zerver": {
        "command": "bun",
        "args": [
            "run",
            "build"
        ]
    }
}

Perplexity MCP Zerver

A minimalist research server implementing the Model Context Protocol (MCP) to deliver AI-powered research capabilities through Perplexity's web interface.

[]()
[]()
[]()
[]()

Research Capabilities

- Intelligent Web Research: Search and summarize content without API limits
- Persistent Conversations: Maintain context with local SQLite chat storage
- Content Extraction: Clean article extraction with GitHub repository parsing
- Developer Tooling: Documentation retrieval, API discovery, code analysis
- Keyless Operation: Browser automation replaces API key requirements

---

Available Tools

Search (`search`)

Perform research queries with configurable depth Returns raw text results

Get Documentation (`get_documentation`)

Retrieve technical documentation with examples Returns structured documentation

Find APIs (`find_apis`)

Discover relevant APIs for development needs Returns API listings and descriptions

Check Deprecated Code (`check_deprecated_code`)

Analyze code snippets for outdated patterns Returns analysis report

Extract URL Content (`extract_url_content`)

Parse web content with automatic GitHub handling Returns structured content metadata

Chat (`chat_perplexity`)

Persistent conversations with context history Returns conversation state in JSON format

---

Getting Started

Prerequisites

- Bun runtime - Node.js 18+ (for TypeScript compilation)

Installation

git clone https://github.com/wysh3/perplexity-mcp-zerver.git
cd perplexity-mcp-zerver
bun install
bun run build

Configuration

Add to your MCP configuration file:

{
  "mcpServers": {
    "perplexity-server": {
      "command": "bun",
      "args": ["/absolute/path/to/build/main.js"],
      "timeout": 300
    }
  }
}

Usage

Initiate commands through your MCP client: - "Use perplexity to research quantum computing advancements" - "Ask perplexity-server for React 18 documentation" - "Begin conversation with perplexity about neural networks"

---

🔐 Pro Account Support (Optional)

Use your Perplexity Pro subscription for access to better models (GPT-5.1, Claude Sonnet 4.5) and higher limits.

One-Time Setup

bun run build
bun run login

A browser window will open. Log in using email (recommended for best compatibility), then close the browser. Your session is now saved!

> Note: Google/SSO login may work but email login is more reliable with the browser automation.

Environment Variables

| Variable | Default | Description |
|----------|---------|-------------|
| PERPLEXITY_BROWSER_DATA_DIR | ~/.perplexity-mcp | Browser profile directory |
| PERPLEXITY_PERSISTENT_PROFILE | true | Set to false for anonymous mode |

---

Technical Comparison

| Feature | This Implementation | Traditional APIs |
|----------------------|---------------------|------------------|
| Authentication | None required | API keys |
| Cost | Free | Usage-based |
| Data Privacy | Local processing | Remote servers |
| GitHub Integration | Native support | Limited |
| History Persistence | SQLite storage | Session-based |

---

Troubleshooting

Server Connection Issues
1. Verify absolute path in configuration
2. Confirm Node.js installation with node -v
3. Ensure build completed successfully

Content Extraction
- GitHub paths must use full repository URLs
- Adjust link recursion depth in source configuration

---

Origins & License

based on - DaInfernalCoder/perplexity-researcher-mcp refactored from - sm-moshi/docshunter

Licensed under GNU GPL v3.0 - View License

---

> This project interfaces with Perplexity via browser automation. Use responsibly and ethically. Stability depends on Perplexity's website consistency. Educational use only.

No reviews yet — be the first

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

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

Perplexity MCP Zerver

Research Capabilities

Available Tools

Search (search)

Get Documentation (get_documentation)

Find APIs (find_apis)

Check Deprecated Code (check_deprecated_code)

Extract URL Content (extract_url_content)

Chat (chat_perplexity)

Getting Started

Prerequisites

Installation

Configuration

Usage

🔐 Pro Account Support (Optional)

One-Time Setup

Environment Variables

Technical Comparison

Troubleshooting

Origins & License

Install

More like this

Brave Search

🔎 GPT Researcher

Github SSE

AWS MCP Servers

Yoyo

whatsapp-mcp

Search (`search`)

Get Documentation (`get_documentation`)

Find APIs (`find_apis`)

Check Deprecated Code (`check_deprecated_code`)

Extract URL Content (`extract_url_content`)

Chat (`chat_perplexity`)