Skip to main content
Glama

Perplexity MCP Server

by laodev1

Perplexity MCP Server

Overview

The Perplexity MCP Server is a Node.js implementation of Anthropic's Model Context Protocol (MCP) that enables Claude to interact with Perplexity's language models. This server provides a secure bridge between Claude and Perplexity AI's capabilities, allowing for enhanced AI interactions through tool use.

Available Tools

The server currently implements two main tools:

1. perplexity_chat

Advanced chat completion tool with full message history support.

{ "name": "perplexity_chat", "description": "Generate a chat completion using Perplexity AI", "parameters": { "model": "string (optional) - One of: llama-3.1-sonar-small-128k-online, llama-3.1-sonar-large-128k-online, llama-3.1-sonar-huge-128k-online", "messages": "array of {role, content} objects - The conversation history", "temperature": "number (optional) - Sampling temperature between 0-2" } }

2. perplexity_ask

Simplified single-query interface for quick questions.

{ "name": "perplexity_ask", "description": "Send a simple query to Perplexity AI", "parameters": { "query": "string - The question or prompt to send", "model": "string (optional) - One of: llama-3.1-sonar-small-128k-online, llama-3.1-sonar-large-128k-online, llama-3.1-sonar-huge-128k-online" } }

Installation

  1. Clone the repository:
    git clone https://github.com/yourusername/perplexity-mcp-server.git cd perplexity-mcp-server
  2. Install dependencies:
    npm install
  3. Create .env file:
    PERPLEXITY_API_KEY=your-api-key-here
  4. Build the project:
    npm run build

Claude Desktop Configuration

To add this server to Claude Desktop, update your claude_desktop_config.json:

{ "mcpServers": { //more servers... "perplexity": { "command": "node", "args": ["path\\to\\perplexity-mcp-server\\dist\\index.js"], "env": { "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY" } } //more servers... } }

The configuration file is typically located at:

  • Windows: %APPDATA%/Claude/config/claude_desktop_config.json
  • macOS: ~/Library/Application Support/Claude/config/claude_desktop_config.json
  • Linux: ~/.config/Claude/config/claude_desktop_config.json

Development

Start the development server with automatic recompilation:

npm run dev

The server uses TypeScript and implements the MCP protocol using the @modelcontextprotocol/sdk package.

Architecture

Core Components

  1. PerplexityServer Class
    • Implements MCP server protocol
    • Handles tool registration and execution
    • Manages error handling and server lifecycle
  2. Tools System
    • Modular tool definitions
    • Type-safe tool handlers
    • Structured input validation

Technical Details

  • Built with TypeScript for type safety
  • Uses @modelcontextprotocol/sdk for MCP implementation
  • Communicates via stdio transport
  • Environment-based configuration

Error Handling

The server implements comprehensive error handling:

  • API error reporting
  • Invalid tool requests handling
  • Connection error management
  • Process signal handling

Dependencies

  • @modelcontextprotocol/sdk: ^1.0.3
  • dotenv: ^16.4.7
  • isomorphic-fetch: ^3.0.0

Contributing

  1. Fork the repository
  2. Create your 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

Security

  • API keys are managed through environment variables
  • Input validation for all tool parameters
  • Error messages are sanitized before output
  • Process isolation through MCP protocol

License

This project is licensed under the ISC License.

Troubleshooting

Common issues and solutions:

  1. Server Not Found
    • Verify the path in claude_desktop_config.json is correct
    • Ensure the server is built (npm run build)
    • Check if Node.js is in your PATH
  2. Authentication Errors
    • Verify your Perplexity API key in .env
    • Check if the API key has the required permissions
  3. Tool Execution Errors
    • Verify the tool parameters match the schema
    • Check network connectivity
    • Review server logs for detailed error messages
Install Server
A
security – no known vulnerabilities
F
license - not found
A
quality - confirmed to work

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.

A Node.js implementation that enables Claude to interact with Perplexity AI's language models through Anthropic's Model Context Protocol, providing tools for advanced chat completions and quick queries.

  1. Overview
    1. Available Tools
      1. 1. perplexity_chat
      2. 2. perplexity_ask
    2. Installation
      1. Claude Desktop Configuration
        1. Development
          1. Architecture
            1. Core Components
            2. Technical Details
          2. Error Handling
            1. Dependencies
              1. Contributing
                1. Security
                  1. License
                    1. Troubleshooting

                      Related MCP Servers

                      • -
                        security
                        F
                        license
                        -
                        quality
                        A comprehensive suite of Model Context Protocol servers designed to extend AI agent Claude's capabilities with integrations for knowledge management, reasoning, advanced search, news access, and workspace tools.
                        Last updated -
                        5
                        TypeScript
                        • Apple
                      • A
                        security
                        A
                        license
                        A
                        quality
                        MCP server that enables Claude to request chat completions with citations from the Perplexity API.
                        Last updated -
                        1
                        MIT License
                        • Apple
                      • -
                        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 -
                        594
                        5
                        JavaScript
                        ISC License
                      • -
                        security
                        F
                        license
                        -
                        quality
                        A Model Context Protocol server that enables Claude AI to interact with PocketBase databases by listing and accessing collections through natural language.
                        Last updated -
                        1
                        1
                        JavaScript
                        • Apple

                      View all related MCP servers

                      MCP directory API

                      We provide all the information about MCP servers via our MCP API.

                      curl -X GET 'https://glama.ai/api/mcp/v1/servers/laodev1/perplexity-mcp-server'

                      If you have feedback or need assistance with the MCP directory API, please join our Discord server