This Perplexity MCP Server is a Node.js implementation of Anthropic's Model Context Protocol that enables Claude to interact with Perplexity AI's language models through two main tools:
- perplexity_chat: Generate advanced chat completions with full message history support, temperature control, and access to models like
mixtral-8x7b-instruct
,codellama-34b-instruct
,sonar-small-chat
, andsonar-small-online
. - perplexity_ask: Send simple, single-query requests to models including
llama-3.1-sonar-small-128k-online
,llama-3.1-sonar-large-128k-online
, andllama-3.1-sonar-huge-128k-online
.
The server is type-safe, modular, secure, and can be integrated with Claude Desktop through configuration.
Enables interaction with Perplexity AI's language models, providing capabilities to generate chat completions with full message history support and send simple queries for quick answers using various Llama-based models.
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.
2. perplexity_ask
Simplified single-query interface for quick questions.
Installation
- Clone the repository:
- Install dependencies:
- Create
.env
file: - Build the project:
Claude Desktop Configuration
To add this server to Claude Desktop, update your claude_desktop_config.json
:
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:
The server uses TypeScript and implements the MCP protocol using the @modelcontextprotocol/sdk
package.
Architecture
Core Components
- PerplexityServer Class
- Implements MCP server protocol
- Handles tool registration and execution
- Manages error handling and server lifecycle
- 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.3dotenv
: ^16.4.7isomorphic-fetch
: ^3.0.0
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
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:
- 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
- Verify the path in
- Authentication Errors
- Verify your Perplexity API key in .env
- Check if the API key has the required permissions
- Tool Execution Errors
- Verify the tool parameters match the schema
- Check network connectivity
- Review server logs for detailed error messages
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.
- Overview
- Available Tools
- Installation
- Claude Desktop Configuration
- Development
- Architecture
- Error Handling
- Dependencies
- Contributing
- Security
- License
- Troubleshooting
Related Resources
Related MCP Servers
- -securityFlicense-qualityA 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 -5TypeScript
- AsecurityAlicenseAqualityMCP server that enables Claude to request chat completions with citations from the Perplexity API.Last updated -1MIT License
- -securityAlicense-qualityA 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 -5945JavaScriptISC License
- -securityFlicense-qualityA Model Context Protocol server that enables Claude AI to interact with PocketBase databases by listing and accessing collections through natural language.Last updated -11JavaScript