====== Perplexity MCP Zerver ======

Perplexity MCP Zerver je MCP server, který umožňuje AI nástrojům (jako Claude, Cursor nebo OpenCode) prohledávat web prostřednictvím Perplexity – bez nutnosti API klíče. Místo toho využívá browserovou automatizaci a napojuje se přímo na existující předplatné Perplexity Pro.

===== Dostupné nástroje =====

Server poskytuje tyto nástroje:

  * ''search'' – vyhledání informací na webu s konfigurovatelnou hloubkou
  * ''get_documentation'' – načtení technické dokumentace s příklady
  * ''find_apis'' – zjištění dostupných API pro daný účel
  * ''check_deprecated_code'' – analýza kódových fragmentů na zastaralé vzory
  * ''extract_url_content'' – extrakce obsahu z URL (včetně GitHub repozitářů)
  * ''chat_perplexity'' – konverzace s persistentní historií uloženou v SQLite

===== Instalace =====

Je potřeba mít nainstalovaný runtime [[https://bun.sh|Bun]] a Node.js 18+.

<code bash>
git clone https://github.com/wysh3/perplexity-mcp-zerver.git
cd perplexity-mcp-zerver
bun install
bun run build
</code>

===== Konfigurace =====

Do konfiguračního souboru MCP klienta se přidá:

<code json>
{
  "mcpServers": {
    "perplexity-server": {
      "command": "bun",
      "args": ["/absolutní/cesta/k/build/main.js"],
      "timeout": 300
    }
  }
}
</code>

Timeout jsem v konfiguraci nenastavoval, ale protože Perplexity může odpovídat pomaleji, doporučuji nastavit ho na vyšší hodnotu, než je výchozí v daném MCP klientovi. Hodnota 300 sekund z README je dobrý základ.

===== Přihlášení a Pro předplatné =====

Aby server mohl využívat Perplexity Pro předplatné – s přístupem k lepším modelům a vyššími limity – je nutné provést jednorázové přihlášení:

<code bash>
bun run login
</code>

Příkaz otevře okno prohlížeče. Doporučuje se přihlásit e-mailem, přihlášení přes Google/SSO může být méně spolehlivé. Po přihlášení se relace uloží do složky ''~/.perplexity-mcp'' v domovském adresáři.

==== Přihlášení při použití Dockeru ====

Pokud AI nástroj běží v Dockeru a přímé přihlášení uvnitř kontejneru není možné, lze se přihlásit na hostitelském systému a session data pak do kontejneru překopírovat:

  - Na hostu spustit přihlášení: ''bun run login''
  - Po úspěšném přihlášení zkopírovat složku ''.perplexity-mcp'' z domovského adresáře hostitele do domovského adresáře uvnitř kontejneru.

Server si session při startu načte automaticky.

===== Alternativní MCP servery s Perplexity API =====

Následující servery na rozdíl od Perplexity MCP Zerveru nevyužívají browserovou automatizaci, ale připojují se přímo k Perplexity API přes API klíč. Některé z nich podporují i hluboký výzkum (deep research).

==== Oficiální Perplexity MCP server ====

[[https://github.com/perplexityai/modelcontextprotocol|perplexityai/modelcontextprotocol]] je oficiální implementace od Perplexity AI. Poskytuje čtyři nástroje:

  * ''perplexity_search'' – přímé vyhledávání přes Perplexity Search API
  * ''perplexity_ask'' – konverzační AI s web searchem (model sonar-pro)
  * ''perplexity_research'' – hluboký výzkum (model sonar-deep-research)
  * ''perplexity_reason'' – pokročilé logické uvažování (model sonar-reasoning-pro)

Instalace přes npx bez nutnosti klonovat repozitář. Konfigurace v Claude Code:

<code bash>
claude mcp add perplexity --env PERPLEXITY_API_KEY="váš_klíč" -- npx -y @perplexity-ai/mcp-server
</code>

Vyžaduje proměnnou prostředí ''PERPLEXITY_API_KEY''. Volitelný parametr ''strip_thinking'' u nástrojů ''perplexity_research'' a ''perplexity_reason'' odstraní z odpovědi ''<think>'' tagy a ušetří tokeny.

==== perplexity-mcp (jsonallen) ====

[[https://github.com/jsonallen/perplexity-mcp|jsonallen/perplexity-mcp]] je jednoduchý Python server s jedním nástrojem ''perplexity_search_web''. Volitelný parametr ''recency'' umožňuje omezit výsledky na den, týden, měsíc nebo rok. Výběrem modelu ''sonar-deep-research'' přes proměnnou ''PERPLEXITY_MODEL'' server podporuje hluboký výzkum.

Instalace přes Smithery:

<code bash>
npx -y @smithery/cli install perplexity-mcp --client claude
</code>

Vyžaduje proměnné prostředí ''PERPLEXITY_API_KEY'' a volitelně ''PERPLEXITY_MODEL'' (výchozí: ''sonar'').

==== perplexity-mcp-server (cyanheads) ====

[[https://github.com/cyanheads/perplexity-mcp-server|cyanheads/perplexity-mcp-server]] je Node.js server se dvěma nástroji:

  * ''perplexity_search'' – rychlé vyhledávání s filtrováním podle recency, domény nebo akademických zdrojů
  * ''perplexity_deep_research'' – hluboký výzkum s nastavitelnou úrovní úsilí (''low'', ''medium'', ''high'')

Deep research může trvat déle; doporučený timeout je 180 sekund. Server odhaduje i náklady volání API na základě spotřebovaných tokenů.

Instalace:

<code bash>
git clone https://github.com/cyanheads/perplexity-mcp-server.git
npm install
npm run build
</code>

Vyžaduje proměnnou prostředí ''PERPLEXITY_API_KEY''.

===== Zdroje =====

  * [[https://github.com/wysh3/perplexity-mcp-zerver|perplexity-mcp-zerver na GitHubu]]
  * [[https://github.com/perplexityai/modelcontextprotocol|Oficiální Perplexity MCP server na GitHubu]]
  * [[https://github.com/jsonallen/perplexity-mcp|jsonallen/perplexity-mcp na GitHubu]]
  * [[https://github.com/cyanheads/perplexity-mcp-server|cyanheads/perplexity-mcp-server na GitHubu]]