Perplexity MCP Server

Integrations

  • Allows to search the web using Perplexity AI by providing a query parameter through the 'perplexity_search' tool

Perplexity MCP Server

This is a simple MCP server that allows you to search the web using Perplexity AI.

Installation

Prerequisites

Steps for Windows

  1. Clone the repository:
git clone [repository-url] cd perplexity-mcp-server
  1. Install dependencies:
npm install
  1. Create environment file:
    • Create a new file named .env in the root directory
    • Add your Perplexity AI API key:
    PERPLEXITY_API_KEY=your_api_key_here

Usage on Windows

Development Mode

npm run dev

Production Mode

  1. Build the project:
npm run build
  1. Start the server:
npm start

To avoid environment variable issues on Windows, use the included batch file:

  1. Build the project first:
npm run build
  1. Run the batch file:
.\run-perplexity-server.bat

Alternatively, double-click the run-perplexity-server.bat file in Windows Explorer.

For detailed instructions, see the Windows Setup Guide.

Troubleshooting Windows Issues

Common Issues

  1. Permission Errors
    • Run Command Prompt or PowerShell as Administrator
    • Check file permissions in the project directory
  2. Environment Variables
    • Ensure .env file is in the root directory
    • No spaces around the = sign in .env file
    • Restart terminal after making changes to environment variables
    • Use the provided batch file to avoid environment variable issues
  3. Node.js Issues
    • Verify Node.js installation: node --version
    • Ensure npm is installed: npm --version

Error Messages

If you see Error: ENOENT: no such file or directory, ensure:

  • All paths use correct Windows-style separators
  • You're in the correct directory
  • Required files exist

Project Structure

perplexity-mcp-server/ ├── src/ │ └── index.ts # Main server implementation ├── dist/ # Compiled output ├── .env # Environment variables ├── package.json # Project configuration ├── run-perplexity-server.bat # Windows batch file └── tsconfig.json # TypeScript configuration

API Usage

The server provides a single tool perplexity_search for web searches:

{ "name": "perplexity_search", "arguments": { "query": "your search query here" } }

License

MIT

You must be authenticated.

A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

This server allows users to perform web searches using Perplexity AI, providing a tool for retrieving search results through a simple API interface.

  1. Installation
    1. Prerequisites
    2. Steps for Windows
  2. Usage on Windows
    1. Development Mode
    2. Production Mode
    3. Using the Windows Batch File (Recommended)
  3. Troubleshooting Windows Issues
    1. Common Issues
    2. Error Messages
  4. Project Structure
    1. API Usage
      1. License

        Related MCP Servers

        • A
          security
          A
          license
          A
          quality
          A server facilitating web search functionality by utilizing Perplexity AI's API, designed to integrate with the Claude desktop client for enhanced search queries.
          Last updated -
          1
          94
          Python
          MIT License
          • Apple
        • A
          security
          A
          license
          A
          quality
          This server enables AI systems to integrate with Tavily's search and data extraction tools, providing real-time web information access and domain-specific searches.
          Last updated -
          2
          5,133
          334
          JavaScript
          MIT License
          • Apple
          • Linux
        • A
          security
          A
          license
          A
          quality
          Facilitates web search capabilities using Perplexity's API, allowing users to retrieve search results through Claude's interface.
          Last updated -
          1
          2
          JavaScript
          MIT License
        • A
          security
          A
          license
          A
          quality
          An MCP server integrating Perplexity AI's API to offer advanced search capabilities with support for multiple models and result configuration.
          Last updated -
          1
          1
          JavaScript
          MIT License

        View all related MCP servers

        ID: uvz269wuup