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
94
Python
MIT License
Second Opinion MCP Server
PoliTwit1984
-
security
F
license
-
quality
Provides AI-powered assistance for coding problems using Google's Gemini AI, combined with Perplexity insights and Stack Overflow references, facilitating contextual analysis and automatic response archiving for improved troubleshooting.
Last updated -
10
TypeScript
AI Development Assistant MCP Server
yeakub108
-
security
A
license
-
quality
A Cursor-compatible toolkit that provides intelligent coding assistance through custom AI tools for code architecture planning, screenshot analysis, code review, and file reading capabilities.
Last updated -
602
2
TypeScript
MIT License
MCP-researcher Server
clssck
-
security
A
license
-
quality
A powerful research assistant that integrates with Cline and Claude Desktop to leverage Perplexity AI for intelligent search, documentation retrieval, API discovery, and code modernization assistance while coding.
Last updated -
2
JavaScript
MIT License

View all related MCP servers

Perplexity MCP Server