Politwit1984 MCP Perplexity Server

🚀 Perplexity MCP Server

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.

✨ 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 methods, including multiple implementation alternatives.
• Best Practices: Include coding standards and error prevention techniques.
• Python Support: Specifically handle Python type errors and common coding issues.

💻 Usage Examples

Basic Usage

Ask questions like:

• "Fix the TypeError in this Python code."
• "What causes this error message?"
• "How to 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:

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

📦 Installation

Prerequisites

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

Option 1: Install from npm (Recommended)

# Use npm
npm install -g perplexity-mcp

# Or use the repository directly
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 content 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 code:

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

🔒 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.

🔧 Technical Details

Project Structure

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

Available Scripts

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

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.

📄 License

This project is released under the MIT License. For details, see the LICENSE file.

🙏 Acknowledgments

• Thanks to Perplexity AI for providing a powerful API.
• Built using Model Context Protocol.