MCP Perplexity Server
About
A MCP Perplexity API server written in Typescript with stdio and SSE transport support.
Details
- License
- MIT
Explore
- Provides MCP‑compatible API for Perplexity AI models
- Supports both stdio and SSE transport protocols
- Configurable default model and model list
- Optional bearer authentication for SSE endpoints
- Easy deployment via Docker Compose or Node.js
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
MCP Perplexity ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Nodejs
pnpm
- Docker
Important: Copy the
.env.sample to .env and set your Perplexity API key.
Use the following docker-compose.yml to quickly set up the server via Portainer (as a stack) or Docker Compose:
services:
mcp-sse-server:
image: ghcr.io/sibbl/mcp-perplexity-api:main
ports:
- "8080:8080"
restart: unless-stopped
environment:
- MCP_TRANSPORT=sse
- MCP_PERPLEXITY_API_KEY=ENTER_YOUR_PERPLEXITY_API_KEY
Save it for Docker compose in a new directory and run docker compose up in it. http://localhost:8080/sse is your endpoint.
To quickly set up the server, run:
docker compose up
To install the required dependencies, run the following command:
pnpm install
To start the server, run:
```bash
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"mcp perplexity server": {
"mcp-perplexity-api": {
"command": "docker",
"args": [
"compose",
"up"
]
}
}
}
}McpServers
{
"mcp-perplexity-api": {
"command": "docker",
"args": [
"compose",
"up"
]
}
}Overview
This repository contains the code for the Model Context Protocol (MCP) Perplexity Server, which is a server that provides an API to ask a question to a model behind the Perplexity API.
Quickstart via Portainer or Docker Compose
Use the following docker-compose.yml to quickly set up the server via Portainer (as a stack) or Docker Compose:
services:
mcp-sse-server:
image: ghcr.io/sibbl/mcp-perplexity-api:main
ports:
- "8080:8080"
restart: unless-stopped
environment:
- MCP_TRANSPORT=sse
- MCP_PERPLEXITY_API_KEY=ENTER_YOUR_PERPLEXITY_API_KEY
# - MCP_SSE_AUTH_HEADER_VALUE=Bearer some_token_which_is_required # enables optional bearer authentication against the MCP server with hard coded value
Save it for Docker compose in a new directory and run docker compose up in it. http://localhost:8080/sse is your endpoint.
Prerequisites
Nodejs
pnpm
- Docker
Important: Copy the
.env.sample to .env and set your Perplexity API key.
Installation via Docker
To quickly set up the server, run:
docker compose up
Installation via Node.js
To install the required dependencies, run the following command:
pnpm install
To start the server, run:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
