MCP Perplexity Server

🚀 Perplexity MCP Server for Intelligent Code Analysis and Debugging

A Model Context Protocol (MCP) server that uses the Perplexity AI API to provide intelligent code analysis and debugging capabilities. It seamlessly integrates with the Claude desktop client.

🚀 Quick Start

The Perplexity MCP Server is designed to offer intelligent code analysis and debugging features. Simply ask questions and attach your code snippets to get detailed error analysis and solutions.

✨ Features

• Intelligent Error Analysis: Break down coding errors in detail and provide root cause analysis.
• Pattern Detection: Automatically identify common error patterns and offer targeted solutions.
• Comprehensive Solutions: Step-by-step repair plans with multiple implementation alternatives.
• Best Practices: Include coding standards and error prevention tips.
• Python Support: Specifically handle Python type errors and common coding issues.

💻 Usage Examples

Basic Usage

Ask questions like:

• "How to fix this TypeError?"
• "What caused this error message?"
• "How to fix this code?"

Attach 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:

1. Root cause analysis of the error
2. Step-by-step solutions with code examples
3. Best practices to prevent similar issues
4. Alternative implementation methods

📦 Installation

Prerequisites

• Node.js 18 or higher
• Perplexity AI API key

Option 1: Install from npm (Recommended)

# Using npm
npm install -g perplexity-mcp

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

Option 2: Install from Source Code

1. Clone the repository:

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

2. Install dependencies:

npm install

3. Build and install globally:

npm run build
npm install -g .

Configure the Claude Desktop Client

Add the following 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 you installed from source code:

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

🔧 Technical Details

Project Structure

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

Available Scripts

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

📄 License

No license information provided in the original document.

🔒 Security

• API keys are securely stored in the Claude desktop configuration file.
• Keys are passed to the server as environment variables.
• No sensitive data is stored in the repository.
• The server expects the API key to be provided by the environment.

🤝 Contribution Guidelines

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