A
securityA
licenseA
qualityA custom MCP tool that integrates Perplexity AI's API with Claude Desktop, allowing Claude to perform web-based research and provide answers with citations.
Last updated -
1
4
MIT License
Provides access to Perplexity's AI models through two tools: 'perplexity_ask' for sending single questions and 'perplexity_chat' for multi-turn conversations, with support for customizable model selection.
Perplexity MCP Server
A custom Model Context Protocol (MCP) implementation that adds Perplexity AI as a tool provider for Claude Desktop.
Features
Seamless integration with Claude Desktop through MCP
Access to Perplexity's powerful AI models
Support for both single questions and multi-turn conversations
Customizable model selection
Installation
Prerequisites
Node.js (v16 or higher)
Claude Desktop (latest version)
Option 1: Clone and Run Locally
Clone this repository:
git clone https://github.com/Family-IT-Guy/perplexity-mcp.git cd perplexity-mcpInstall dependencies:
npm installCreate a
.envfile with your API key:PERPLEXITY_API_KEY=your_api_key_hereTest the server:
node server.js
Option 2: Install Globally
Clone and navigate to the repository as above
Install globally:
npm install -g .Now you can run the server from anywhere:
perplexity-mcp
Claude Desktop Configuration
Add this configuration to your claude_desktop_config.json file:
Standard Configuration
{
"mcpServers": {
"perplexity": {
"command": "node",
"args": [
"/absolute/path/to/perplexity-mcp/server.js"
],
"env": {
"PERPLEXITY_API_KEY": "your_perplexity_api_key"
}
}
}
}
Global Installation Configuration
{
"mcpServers": {
"perplexity": {
"command": "npx",
"args": [
"perplexity-mcp"
],
"env": {
"PERPLEXITY_API_KEY": "your_perplexity_api_key"
}
}
}
}
NVM Users
If you're using Node Version Manager (NVM), you need absolute paths:
{
"mcpServers": {
"perplexity": {
"command": "/Users/username/.nvm/versions/node/v16.x.x/bin/node",
"args": [
"/Users/username/path/to/perplexity-mcp/server.js"
],
"env": {
"PERPLEXITY_API_KEY": "your_perplexity_api_key"
}
}
}
}
Available Tools
Once configured, Claude will have access to these tools:
perplexity_ask - Send a single question to Perplexity
Parameters:
query(required): The question to askmodel(optional): Model name (default:llama-3.1-sonar-small-128k-online)
perplexity_chat - Have a multi-turn conversation
Parameters:
messages(required): Array of conversation messagesmodel(optional): Model name (default:mixtral-8x7b-instruct)
Troubleshooting
Check logs:
cat ~/.claude/logs/perplexity.logEnsure your API key is valid
Verify your claude_desktop_config.json format
Enable verbose logging by adding
"DEBUG": "1"to the env section
How It Works
This implementation uses the Model Context Protocol (MCP) created by Anthropic to extend Claude Desktop's capabilities. It:
Creates an MCP server that communicates with Claude via stdio
Registers Perplexity tools with Claude
Proxies requests from Claude to the Perplexity API
Returns responses back to Claude for display
License
This project is licensed under the ISC License - see the LICENSE file for details.
This server cannot be installed
hybrid server
The server is able to function both locally and remotely, depending on the configuration or use case.
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.
Related MCP Servers
- AsecurityFlicenseAqualityA 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.Last updated -1756
- -securityFlicense-qualityA Model Context Protocol implementation that connects Claude Desktop with OmniFocus 4, enabling natural language task management through AI.