https://github.com/Alcova-AI/perplexity-mcp
An MCP server for the Perplexity for use with Claude Code and Claude Desktop, giving you enhanced search and reasoning capabilties.
https://github.com/Alcova-AI/perplexity-mcp
ai claude llm mcp-server perplexity-api
Last synced: 5 months ago
JSON representation
An MCP server for the Perplexity for use with Claude Code and Claude Desktop, giving you enhanced search and reasoning capabilties.
- Host: GitHub
- URL: https://github.com/Alcova-AI/perplexity-mcp
- Owner: Alcova-AI
- License: mit
- Created: 2025-03-20T02:09:02.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-03-20T05:49:55.000Z (11 months ago)
- Last Synced: 2025-06-10T11:12:59.930Z (8 months ago)
- Topics: ai, claude, llm, mcp-server, perplexity-api
- Language: Go
- Homepage:
- Size: 36.1 KB
- Stars: 8
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
- awesome-mcp-servers - **perplexity-mcp** - An MCP server for the Perplexity for use with Claude Code and Claude Desktop, giving you enhanced search and reasoning capabilties. `go` `ai` `claude` `llm` `mcp-server` `go install Alcova-AI/perplexity-mcp@latest` (🤖 AI/ML)
README
# Perplexity MCP Server
A Model Context Protocol (MCP) server for the Perplexity API written in Go. This server enables AI assistants like Claude (Code and Desktop) and Cursor to seamlessly access Perplexity's powerful search and reasoning capabilities directly from their interfaces.
## Description
The Perplexity MCP Server acts as a bridge between AI assistants and the Perplexity API, allowing them to:
1. **Search the web and retrieve up-to-date information** using Perplexity's Sonar Pro model via the `perplexity_ask` tool
2. **Perform complex reasoning tasks** using Perplexity's Sonar Reasoning Pro model via the `perplexity_reason` tool
This integration lets AI assistants like Claude access real-time information and specialized reasoning capabilities without leaving their interface, creating a seamless experience for users.
### Key Benefits
- **Access to real-time information**: Get current data, news, and information from the web
- **Enhanced reasoning capabilities**: Leverage specialized models for complex problem-solving tasks
- **Seamless integration**: Works natively with Claude Code, Claude Desktop, and Cursor
- **Simple installation**: Quick setup with Homebrew, Go, or pre-built binaries
- **Customizable**: Configure which Perplexity models to use for different tasks
## Installation
### Using Homebrew (macOS and Linux)
```sh
brew tap alcova-ai/tap
brew install perplexity-mcp
```
### From Source
Clone the repository and build manually:
```sh
git clone https://github.com/Alcova-AI/perplexity-mcp.git
cd perplexity-mcp
go build -o perplexity-mcp-server .
```
### From Binary Releases (Other platforms)
Download pre-built binaries from the [releases page](https://github.com/Alcova-AI/perplexity-mcp/releases).
## Usage
This server supports only the `stdio` protocol for MCP communication.
### Setup with Claude Code
Adding to Claude Code:
```sh
claude mcp add-json --scope user perplexity-mcp '{"type":"stdio","command":"perplexity-mcp","env":{"PERPLEXITY_API_KEY":"pplx-YOUR-API-KEY-HERE"}}'
```
That's it! You can now use Perplexity in Claude Code.
### Setup with Claude Desktop
Adding to Claude Desktop:
1. Exit the Claude Desktop MCP config:
```sh
code ~/Library/Application\ Support/Claude/claude_desktop_config.json
```
2. Add the Perplexity MCP server:
```diff
{
"mcpServers": {
+ "perplexity-mcp": {
+ "command": "perplexity-mcp",
+ "args": [
+ "--model",
+ "sonar-pro",
+ "--reasoning-model",
+ "sonar-reasoning-pro"
+ ],
+ "env": {
+ "PERPLEXITY_API_KEY": "pplx-YOUR-API-KEY-HERE"
+ }
+ }
}
}
```
### Command Line Options
- `--model, -m`: Specify the Perplexity model to use for search (default: "sonar-pro")
- Can also be set with the `PERPLEXITY_MODEL` environment variable
- `--reasoning-model, -r`: Specify the Perplexity model to use for reasoning (default: "sonar-reasoning-pro")
- Can also be set with the `PERPLEXITY_REASONING_MODEL` environment variable
Example:
```sh
perplexity-mcp --model sonar-pro --reasoning-model sonar-reasoning-pro
```
### Direct Execution
If you want to run the server directly (not recommended for most users):
1. Set your Perplexity API key as an environment variable:
```sh
export PERPLEXITY_API_KEY=your-api-key-here
```
2. Run the server:
```sh
perplexity-mcp
```
## License
MIT