Perplexity MCP Server

A Model Context Protocol (MCP) server that provides intelligent code analysis and debugging capabilities using Perplexity AI's API. Works seamlessly with the Claude desktop client.

Features

Intelligent Error Analysis: Detailed breakdown of coding errors with root cause analysis
Pattern Detection: Automatically recognizes common error patterns and provides targeted solutions
Comprehensive Solutions: Step-by-step fixes with multiple implementation alternatives
Best Practices: Includes coding standards and error prevention tips
Python Support: Specialized handling of Python type errors and common coding issues

Example Usage

Ask questions like:

"Fix this TypeError in my Python code"
"What's causing this error message?"
"How do I fix this code?"

Include your code snippet for targeted analysis:

def calculate_total(items):
    total = 0
    for item in items:
        total = total + item['price']  # TypeError: string + int

data = [
    {'name': 'Book', 'price': '10'},
    {'name': 'Pen', 'price': '2'}
]

result = calculate_total(data)

The server will provide:

Root cause analysis of the error
Step-by-step solution with code examples
Best practices to prevent similar issues
Alternative implementation approaches

Installation

Prerequisites

Node.js 18 or higher
A Perplexity AI API key

Option 1: Install from npm (Recommended)

# Using npm
npm install -g perplexity-mcp

# Or using the repository directly
npm install -g git+https://github.com/yourusername/perplexity-mcp.git

Option 2: Install from Source

Clone the repository:

git clone https://github.com/yourusername/perplexity-server.git
cd perplexity-server

Install dependencies:

npm install

Build and install globally:

npm run build
npm install -g .

Configure Claude Desktop

Add to your Claude desktop configuration file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "perplexity": {
      "command": "perplexity-mcp",
      "args": [],
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Or if installed from source:

{
  "mcpServers": {
    "perplexity": {
      "command": "node",
      "args": ["/absolute/path/to/perplexity-server/build/index.js"],
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Security

The API key is stored securely in Claude's desktop configuration file
The key is passed to the server as an environment variable
No sensitive data is stored in the repository
The server expects the API key to be provided by Claude's environment

Development

Project Structure

perplexity-server/
├── src/
│   └── index.ts      # Main server implementation
├── package.json      # Project configuration
└── tsconfig.json    # TypeScript configuration

Available Scripts

npm run build: Build the project
npm run watch: Watch for changes and rebuild automatically
npm run prepare: Prepare the package for publishing
npm run inspector: Run the MCP inspector for debugging

Contributing

Fork the repository
Create your feature branch (git checkout -b feature/amazing-feature)
Commit your changes (git commit -m 'Add some amazing feature')
Push to the branch (git push origin feature/amazing-feature)
Open a Pull Request

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

Thanks to Perplexity AI for their powerful API
Built with Model Context Protocol

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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.

Tools

Enables intelligent code analysis and debugging through the Perplexity AI's API, offering detailed error analysis, pattern detection, and comprehensive solutions, with integration support for the Claude desktop client.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Perplexity MCP Server
jsonallen
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
205
Python
MIT License
MCP Code Analyzer
emiryasar
-
security
A
license
-
quality
A comprehensive code analysis and management tool that integrates with Claude Desktop to analyze code at project and file levels, helping adapt changes to projects intelligently.
Last updated -
37
Python
MIT License
Perplexity Tool for Claude Desktop
letsbuildagent
A
security
A
license
A
quality
A custom MCP tool that integrates Perplexity AI's API with Claude Desktop, allowing Claude to perform web-based research and provide answers with citations.
Last updated -
1
4
JavaScript
MIT License
Perplexity MCP Server
Family-IT-Guy
-
security
A
license
-
quality
A custom Model Context Protocol implementation that integrates Perplexity AI with Claude Desktop, allowing users to access Perplexity's AI models for both single questions and multi-turn conversations.
Last updated -
696
5
JavaScript
ISC License

View all related MCP servers

Perplexity MCP Server