perplexity-mcp-zerver
MCP web search using perplexity without any API KEYS
Safety scan
A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.
Badge for your README
Markdown
[](/listings/wysh3--perplexity-mcp-zerver)HTML
<a href="/listings/wysh3--perplexity-mcp-zerver"><img src="/api/listings/wysh3--perplexity-mcp-zerver/badge.svg" alt="findsafeskills safety rating" /></a>Install
Install instructions from the README
As written by the repo's author. findsafeskills has not verified these steps.
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"
---
What was scanned
The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.
README.md · README · 141 lines
View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)
- # 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
- ```bash
- 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:
- ```json
- {
- "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
- ```bash
- 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](https://github.com/DaInfernalCoder/perplexity-researcher-mcp)
- refactored from - [sm-moshi/docshunter](https://github.com/sm-moshi/docshunter)
- Licensed under **GNU GPL v3.0** - [View License](LICENSE)
- ---
- > This project interfaces with Perplexity via browser automation. Use responsibly and ethically. Stability depends on Perplexity's website consistency. Educational use only.
Ratings and comments
Sign in to rate this skill.
Sign inFree to use. If it’s helped, pass it on.