Perplexity Sonar MCP

🚀 Perplexity Sonar MCP Server

A powerful MCP server that implements Perplexity's Sonar model, providing support for Claude Desktop and other MCP clients. Unlike traditional MCP servers, this implementation offers access to Perplexity's advanced AI models with web search capabilities, enabling Claude to perform real - time web searches during conversations and provide up - to - date information.

🚀 Quick Start

Why Choose Perplexity Sonar MCP?

• Real - time Web Search: Obtain current information during conversations.
• Multiple Models to Choose From: Select the appropriate Sonar model according to your needs:
  • sonar: A balanced general - purpose model.
  • sonar - pro: Enhanced features for complex tasks.
  • sonar - reasoning: Focused on logical reasoning and analysis.
  • sonar - deep - research: In - depth research with detailed references.
• Rich Parameter Options: Fine - tune queries with numerous parameters:
  • Control search domains and recency.
  • Adjust response formats (Markdown/JSON).
  • Set temperature and token generation limits.
  • Get related questions and images.
• Seamless Integration: Perfectly compatible with Claude Desktop and other tools.

Installation Requirements

1. Operating System: Windows, macOS, or Linux.
2. Node.js Version: >=14.x.x.
3. Internet Connection: Required to access data.

Usage Instructions

Install via npm Package Manager

npm install -g perlexity-sonar-mcp-server

Use in Claude Desktop

1. Open a terminal or command prompt.
2. Start the server:

   mcp-server start --port 3000
   

3. Configure the MCP server address as http://localhost:3000 in Claude Desktop's settings.

Stand - Alone Mode

1. Clone the repository:

   git clone https://github.com/felores/perplexity-sonar-mcp.git
   cd perplexity-sonar-mcp
   

2. Install dependencies:

   npm install
   

3. Start the server:

   npm start
   

✨ Features

API Reference

Interface Definition

interface PerplexitySonarMCP {
  search(query: string, options?: SearchOptions): Promise<SearchResult>;
}

Search Options

type SearchOptions = {
  model?: "sonar" | "sonar-pro" | "sonar-reasoning" | "sonar-deep-research";
  domain?: string[];
  searchRecency?: "hour" | "day" | "week" | "month";
  maxResults?: number;
};

Search Results

type SearchResult = {
  results: ResultItem[];
  error?: string;
};

type ResultItem = {
  title: string;
  url: string;
  content: string;
  source: string;
  date: string;
};

Usage Examples

Basic Usage

const perplexityMcp = new PerplexitySonarMCP();
const result = await perplexityMcp.search("The current state of AI");

Advanced Usage

const options: SearchOptions = {
  model: "sonar-deep-research",
  domain: ["arxiv.org", "nature.com"],
  searchRecency: "week"
};
const result = await perplexityMcp.search("The latest research on large language models", options);

📦 Installation

Development

1. Clone the repository:

   git clone https://github.com/felores/perplexity-sonar-mcp.git
   cd perplexity-sonar-mcp
   

2. Install dependencies:

   npm install
   

3. Build the project:

   npm run build
   

4. Start in development mode:

   npm run dev
   

📚 Documentation

Troubleshooting

1. Verify that the API key is correct.
2. Ensure that the Node.js version meets the requirements.
3. Check Claude Desktop logs:
   • macOS: ~/Library/Logs/Claude/mcp.log
   • Windows: %APPDATA%\Claude\logs\mcp.log
4. Try running in stand - alone mode to isolate the problem.

📄 License

MIT