Skip to content
Back to search

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.

Checked today
Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/wysh3--perplexity-mcp-zerver/badge.svg)](/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

i

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)

  1. # Perplexity MCP Zerver
  2. A minimalist research server implementing the Model Context Protocol (MCP) to deliver AI-powered research capabilities through Perplexity's web interface.
  3. [![MCP Compatible](https://img.shields.io/badge/MCP-Compatible-333)]()
  4. [![TypeScript Codebase](https://img.shields.io/badge/TypeScript-Codebase-333)]()
  5. [![Tests Passing](https://img.shields.io/badge/Tests-Passing-333)]()
  6. [![Bun Runtime](https://img.shields.io/badge/Runtime-Bun-333)]()
  7. ## Research Capabilities
  8. - **Intelligent Web Research**: Search and summarize content without API limits
  9. - **Persistent Conversations**: Maintain context with local SQLite chat storage
  10. - **Content Extraction**: Clean article extraction with GitHub repository parsing
  11. - **Developer Tooling**: Documentation retrieval, API discovery, code analysis
  12. - **Keyless Operation**: Browser automation replaces API key requirements
  13. ---
  14. ## Available Tools
  15. ### Search (`search`)
  16. Perform research queries with configurable depth
  17. *Returns raw text results*
  18. ### Get Documentation (`get_documentation`)
  19. Retrieve technical documentation with examples
  20. *Returns structured documentation*
  21. ### Find APIs (`find_apis`)
  22. Discover relevant APIs for development needs
  23. *Returns API listings and descriptions*
  24. ### Check Deprecated Code (`check_deprecated_code`)
  25. Analyze code snippets for outdated patterns
  26. *Returns analysis report*
  27. ### Extract URL Content (`extract_url_content`)
  28. Parse web content with automatic GitHub handling
  29. *Returns structured content metadata*
  30. ### Chat (`chat_perplexity`)
  31. Persistent conversations with context history
  32. *Returns conversation state in JSON format*
  33. ---
  34. ## Getting Started
  35. ### Prerequisites
  36. - Bun runtime
  37. - Node.js 18+ (for TypeScript compilation)
  38. ### Installation
  39. ```bash
  40. git clone https://github.com/wysh3/perplexity-mcp-zerver.git
  41. cd perplexity-mcp-zerver
  42. bun install
  43. bun run build
  44. ```
  45. ### Configuration
  46. Add to your MCP configuration file:
  47. ```json
  48. {
  49. "mcpServers": {
  50. "perplexity-server": {
  51. "command": "bun",
  52. "args": ["/absolute/path/to/build/main.js"],
  53. "timeout": 300
  54. }
  55. }
  56. }
  57. ```
  58. ### Usage
  59. Initiate commands through your MCP client:
  60. - "Use perplexity to research quantum computing advancements"
  61. - "Ask perplexity-server for React 18 documentation"
  62. - "Begin conversation with perplexity about neural networks"
  63. ---
  64. ## 🔐 Pro Account Support (Optional)
  65. Use your Perplexity Pro subscription for access to better models (GPT-5.1, Claude Sonnet 4.5) and higher limits.
  66. ### One-Time Setup
  67. ```bash
  68. bun run build
  69. bun run login
  70. ```
  71. A browser window will open. **Log in using email** (recommended for best compatibility), then close the browser. Your session is now saved!
  72. > **Note**: Google/SSO login may work but email login is more reliable with the browser automation.
  73. ### Environment Variables
  74. | Variable | Default | Description |
  75. |----------|---------|-------------|
  76. | `PERPLEXITY_BROWSER_DATA_DIR` | `~/.perplexity-mcp` | Browser profile directory |
  77. | `PERPLEXITY_PERSISTENT_PROFILE` | `true` | Set to `false` for anonymous mode |
  78. ---
  79. ## Technical Comparison
  80. | Feature | This Implementation | Traditional APIs |
  81. |----------------------|---------------------|------------------|
  82. | Authentication | None required | API keys |
  83. | Cost | Free | Usage-based |
  84. | Data Privacy | Local processing | Remote servers |
  85. | GitHub Integration | Native support | Limited |
  86. | History Persistence | SQLite storage | Session-based |
  87. ---
  88. ## Troubleshooting
  89. **Server Connection Issues**
  90. 1. Verify absolute path in configuration
  91. 2. Confirm Node.js installation with `node -v`
  92. 3. Ensure build completed successfully
  93. **Content Extraction**
  94. - GitHub paths must use full repository URLs
  95. - Adjust link recursion depth in source configuration
  96. ---
  97. ## Origins & License
  98. based on - [DaInfernalCoder/perplexity-researcher-mcp](https://github.com/DaInfernalCoder/perplexity-researcher-mcp)
  99. refactored from - [sm-moshi/docshunter](https://github.com/sm-moshi/docshunter)
  100. Licensed under **GNU GPL v3.0** - [View License](LICENSE)
  101. ---
  102. > 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 in

Free to use. If it’s helped, pass it on.