local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables interaction with Perplexity AI's language models, providing capabilities to generate chat completions with full message history support and send simple queries for quick answers using various Llama-based models.

Perplexity MCP サーバー

概要

Perplexity MCPサーバーは、Anthropicのモデルコンテキストプロトコル（MCP）のNode.js実装であり、ClaudeがPerplexityの言語モデルとやり取りできるようにします。このサーバーは、ClaudeとPerplexity AIの機能の間に安全な橋渡しを提供し、ツールの使用を通じてAIとのやり取りを強化します。

利用可能なツール

現在、サーバーは次の 2 つの主要なツールを実装しています。

1. パープレキシティチャット

完全なメッセージ履歴をサポートする高度なチャット完了ツール。

{
  "name": "perplexity_chat",
  "description": "Generate a chat completion using Perplexity AI",
  "parameters": {
    "model": "string (optional) - One of: llama-3.1-sonar-small-128k-online, llama-3.1-sonar-large-128k-online, llama-3.1-sonar-huge-128k-online",
    "messages": "array of {role, content} objects - The conversation history",
    "temperature": "number (optional) - Sampling temperature between 0-2"
  }
}

2. 困惑の質問

簡単な質問のための簡素化された単一クエリインターフェース。

{
  "name": "perplexity_ask",
  "description": "Send a simple query to Perplexity AI",
  "parameters": {
    "query": "string - The question or prompt to send",
    "model": "string (optional) - One of: llama-3.1-sonar-small-128k-online, llama-3.1-sonar-large-128k-online, llama-3.1-sonar-huge-128k-online"
  }
}

インストール

リポジトリをクローンします。
git clone https://github.com/yourusername/perplexity-mcp-server.git cd perplexity-mcp-server
依存関係をインストールします:
npm install
.envファイルを作成します:
PERPLEXITY_API_KEY=your-api-key-here
プロジェクトをビルドします。
npm run build

クロードデスクトップ構成

このサーバーをClaude Desktopに追加するには、 claude_desktop_config.jsonを更新します。

{
  "mcpServers": {
    //more servers...
    "perplexity": {
      "command": "node",
      "args": ["path\\to\\perplexity-mcp-server\\dist\\index.js"],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY"
      }
    }
    //more servers...
  }
}

構成ファイルは通常、次の場所にあります。

Windows: %APPDATA%/Claude/config/claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/config/claude_desktop_config.json
Linux: ~/.config/Claude/config/claude_desktop_config.json

発達

自動再コンパイルで開発サーバーを起動します。

npm run dev

サーバーは TypeScript を使用し、 @modelcontextprotocol/sdkパッケージを使用して MCP プロトコルを実装します。

建築

コアコンポーネント

PerplexityServer クラス
- MCPサーバープロトコルを実装
- ツールの登録と実行を処理する
- エラー処理とサーバーのライフサイクルを管理します
ツールシステム
- モジュラーツールの定義
- 型安全なツールハンドラー
- 構造化された入力検証

技術的な詳細

型安全性のためにTypeScriptで構築
MCP実装には@modelcontextprotocol/sdkを使用します
stdioトランスポート経由で通信する
環境ベースの構成

エラー処理

サーバーは包括的なエラー処理を実装します。

APIエラー報告
無効なツール要求の処理
接続エラー管理
プロセス信号処理

依存関係

@modelcontextprotocol/sdk : ^1.0.3
dotenv :^16.4.7
isomorphic-fetch : ^3.0.0

貢献

リポジトリをフォークする
機能ブランチを作成します（ git checkout -b feature/amazing-feature ）
変更をコミットします ( git commit -m 'Add some amazing feature' )
ブランチにプッシュする ( git push origin feature/amazing-feature )
プルリクエストを開く

安全

APIキーは環境変数を通じて管理されます
すべてのツールパラメータの入力検証
エラーメッセージは出力前にサニタイズされます
MCPプロトコルによるプロセス分離

ライセンス

このプロジェクトは ISC ライセンスに基づいてライセンスされています。

トラブルシューティング

よくある問題と解決策:

サーバーが見つかりません
- claude_desktop_config.jsonのパスが正しいことを確認します
- サーバーがビルドされていることを確認する（ npm run build ）
- Node.jsがPATHにあるか確認する
認証エラー
- .env で Perplexity API キーを確認します
- APIキーに必要な権限があるか確認する
ツール実行エラー
- ツールパラメータがスキーマと一致していることを確認する
- ネットワーク接続を確認する
- 詳細なエラーメッセージについてはサーバーログを確認してください

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

Claude が Anthropic のモデルコンテキストプロトコルを介して Perplexity AI の言語モデルと対話できるようにし、高度なチャット補完とクイッククエリのためのツールを提供する Node.js 実装。

Related Resources

Reddit Discussion about this server

Perplexity MCP Server