Perplexity Search MCP

This is a tool based on the Model Context Protocol (MCP) that wraps the search functionality of Perplexity AI into a standardized tool that can be called via MCP.

This project is built with TypeScript and runs on the Bun runtime.

✨ Features

• Provides the perplexity-search tool via MCP.
• Supports various parameters for Perplexity search, such as:
  • query: A single or multiple search queries.
  • max_results: Specifies the maximum number of results to return.
  • country: Filters search results by geographic location.
  • search_mode: Supports web, academic, and sec search modes.
• Communicates with the host environment via standard input/output (Stdio).

🚀 Getting Started

1. Prerequisites

• Ensure you have Bun installed.
• You will need an API key from Perplexity AI.

2. Installation

After cloning the project, run the following command in the root directory to install the required dependencies:

bun install

3. Configuration

This server requires the PERPLEXITY_API_KEY environment variable to be set.

4. Running the Server (Development)

To run the server directly from the TypeScript source for development, execute the following command:

bun run index.ts

The server will start and listen for MCP messages on standard I/O.

5. Building the Project

You can also build the project into a single, optimized JavaScript file.

bun run build

This command compiles index.ts and places the output in dist/perplexity-search-mcp.js.

After building, you can run the compiled file directly:

bun dist/perplexity-search-mcp.js
or
node dist/perplexity-search-mcp.js

🛠️ Tool Definition

perplexity-search

Description: Get ranked search results from Perplexity’s continuously refreshed index with advanced filtering and customization options.

Input Parameters:

Parameter	Type	Description	Default
query	string or string[]	The search query or queries to execute.	Required
max_results	number	The maximum number of search results to return (max 20).	10
country	string	Country code to filter results by geographic location (e.g., 'US', 'GB', 'DE').	Optional
max_tokens_per_page	number	Controls the maximum number of tokens retrieved from each webpage. Higher values provide more comprehensive content but may increase processing time.	2048
search_mode	string	The search mode. Can be web, academic, or sec.	web

Output:

The tool returns a JSON string containing an array of search results from the Perplexity API.