MCP-researcher Server

A powerful research assistant that integrates with Cline and Claude Desktop! Leverages Perplexity AI for intelligent search, documentation retrieval, API discovery, and code modernization assistance - all while you code.

Features

Seamless Context Tracking: Maintains conversation history in SQLite database to provide coherent responses across multiple queries
Advanced Query Processing: Uses Perplexity's Sonar models for sophisticated reasoning and detailed answers to complex questions
Intelligent Rate Management: Implements adaptive rate limiting with exponential backoff to maximize API usage without hitting limits
High Performance Networking: Optimizes API calls with connection pooling and automatic retry logic for reliable operation

Tools

1. Search

Performs general search queries to get comprehensive information on any topic. The example shows how to use different detail levels (brief, normal, detailed) to get tailored responses.

2. Get Documentation

Retrieves documentation and usage examples for specific technologies, libraries, or APIs. The example demonstrates getting comprehensive documentation for React hooks, including best practices and common pitfalls.

3. Find APIs

Discovers and evaluates APIs that could be integrated into a project. The example shows finding payment processing APIs with detailed analysis of features, pricing, and integration complexity.

4. Check Deprecated Code

Analyzes code for deprecated features or patterns, providing migration guidance. The example demonstrates checking React class components and lifecycle methods for modern alternatives.

Installation

paste this part into claude directly if you want to, the ai can install it for you

First install Node.js if not already installed (from nodejs.org)
Clone the repo
Install dependencies and build
Get a Perplexity API key from https://www.perplexity.ai/settings/api
Create the MCP settings file in the appropriate location for your OS:
To use with Claude Desktop, add the server config:
To use with Cline, add into mcpServers:

{
  "mcpServers": {
    "perplexity-server": {
      "command": "node",
      "args": ["[path/to/researcher-mcp/build/index.js]"],
      "env": {
        "PERPLEXITY_API_KEY": "pplx-...",
        "PERPLEXITY_MODEL": "sonar-reasoning" // you can use different models
      },
      "disabled": false,
      "alwaysAllow": [],
      "autoApprove": [
        "search",
        "get_documentation",
        "find_apis",
        "check_deprecated_code",
        "get_request_status"
      ]
    }
  }
}

Build the server: npm run build

Features

Seamless Context Tracking: Maintains conversation history in SQLite database to provide coherent responses across multiple queries

Advanced Query Processing: Uses Perplexity's Sonar models for sophisticated reasoning and detailed answers to complex questions

Intelligent Rate Management: Implements adaptive rate limiting with exponential backoff to maximize API usage without hitting limits

High Performance Networking: Optimizes API calls with connection pooling and automatic retry logic for reliable operation

Tools

1. Search

Performs general search queries to get comprehensive information on any topic. The example shows how to use different detail levels (brief, normal, detailed) to get tailored responses.

2. Get Documentation

3. Find APIs

Discovers and evaluates APIs that could be integrated into a project. The example shows finding payment processing APIs with detailed analysis of features, pricing, and integration complexity.

4. Check Deprecated Code

Analyzes code for deprecated features or patterns, providing migration guidance. The example demonstrates checking React class components and lifecycle methods for modern alternatives.

Installation

paste this part into claude directly if you want to, the ai can install it for you

First install Node.js if not already installed (from nodejs.org)

Clone the repo

Install dependencies and build

Get a Perplexity API key from https://www.perplexity.ai/settings/api

Create the MCP settings file in the appropriate location for your OS:

To use with Claude Desktop, add the server config:

To use with Cline, add into mcpServers:

{ "mcpServers": { "perplexity-server": { "command": "node", "args": ["[path/to/researcher-mcp/build/index.js]"], "env": { "PERPLEXITY_API_KEY": "pplx-...", "PERPLEXITY_MODEL": "sonar-reasoning" // you can use different models }, "disabled": false, "alwaysAllow": [], "autoApprove": [ "search", "get_documentation", "find_apis", "check_deprecated_code", "get_request_status" ] } } }

Build the server: npm run build