home / mcp / mcp perplexity server

MCP Perplexity Server

A lightweight Python MCP server that echoes received messages for testing and diagnostics.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "ibm-chuk-mcp-perplexity": {
      "command": "chuk-mcp-perplexity",
      "args": [],
      "env": {
        "NO_BOOTSTRAP": "true"
      }
    }
  }
}

You can run the MCP Perplexity Server to quickly test MCP-based messaging by sending a message and receiving it back. This lightweight Python-based service is ideal for validating client integrations, diagnosing transport issues, and verifying echo-style interactions within the MCP ecosystem.

How to use

To use this MCP server, start the executable provided by the installed package and connect your MCP client to it. You will send a message to the Echo endpoint, and the server will return the exact same message. This behavior makes it ideal for validating message formatting, transport reliability, and end-to-end data flow during development and testing.

How to install

Prerequisites you need before installation.

Install from PyPI to obtain the MCP Perplexity Server quickly.

pip install chuk-mcp-perplexity

If you prefer to install from source, follow these steps to clone the repository, set up a virtual environment, and install in editable mode.

git clone <repository-url>
cd chuk-mcp-perplexity
python -m venv venv
# On macOS/Linux:
source venv/bin/activate
# On Windows:
venv\Scripts\activate
pip install .  # Installs the package in editable mode

For development setup, install with development dependencies.

pip install .[dev]

Running the server

You can run the server directly from the command line, or start it programmatically if you prefer to embed it in custom tooling.

chuk-mcp-perplexity

If you want to initialize and boot the server from code, you can import and call the main function.

from chuk_mcp_perplexity.main import main

if __name__ == "__main__":
    main()

Available tools

echo

Echoes back the input message and returns an EchoResult object to the caller.