MCP Perplexity Server
About
A MCP Perplexity API server written in Typescript with stdio and SSE transport support.
Details
- Author
- sibbl
- GitHub stars
- 2
- Downloads
- 449
- Categories
- AI
Jump to
- 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
Set up the server via Docker (docker compose up) or Node.js (pnpm install && pnpm start after setting environment variables). You must configure MCP_PERPLEXITY_API_KEY with your Perplexity API key. The server runs on stdio (default) or SSE transport; for SSE, the endpoint is http://localhost:8080/sse by default.
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"
]
}
}MCP Perplexity Server
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.
