mcpField
M
MCP Perplexity Server

MCP Perplexity Server

Local
github.com/sibblAI & Agents2Updated 84w ago
Repository

About MCP Perplexity Server

MCP Perplexity Server is a TypeScript MCP server that lets MCP clients ask questions through the Perplexity API. It supports stdio and SSE transports and configurable Perplexity models.

Key features

  1. 01Ask questions through the Perplexity API
  2. 02stdio and SSE transport support
  3. 03Configure available and default models

Use cases

  1. 01Expose Perplexity queries to an MCP client
  2. 02Serve MCP over SSE for remote access

MCP support

It exposes Perplexity question answering to MCP clients as an MCP server, using stdio or SSE transport.

#mcp-perplexity-api#api-server#typescript

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "perplexity-api": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "compose"
      ]
    }
  }
}
Run commanddocker run -i --rm compose

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
ocicompose

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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:


# with stdio transport
export MCP_TRANSPORT=stdio # optional, stdio is default
pnpm start

# or

# with SSE transport
export MCP_TRANSPORT=sse
pnpm start

Configuration

All configuration options:

  • MCP_PERPLEXITY_API_KEY: Perplexity API key to use. Required.
  • MCP_TRANSPORT: Either stdio or sse. Default is stdio.
  • MCP_PERPLEXITY_DEFAULT_MODEL: The perplexity default model to use. Default is sonar-pro.
  • MCP_PERPLEXITY_MODELS: Comma separated list of models to use. Default is sonar,sonar-pro.
  • MCP_PERPLEXITY_TOOL_DESCRIPTION_SUFFIX: The suffix to use for the tool description. Empty by default.
  • MCP_SSE_ENDPOINT: The endpoint to use for SSE. Default is /sse.
  • MCP_SSE_PORT: The port to use for SSE. Default is 8080.
  • MCP_SSE_AUTH_HEADER_KEY: The auth header key to use for SSE. Default is Authorization.
  • MCP_SSE_AUTH_HEADER_VALUE: The auth header value to use for SSE. By default no value is set, which means that no authorization is required.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.