Perplexity MCP サーバー

概要

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

Related MCP server: Perplexity MCP Server

利用可能なツール

現在、サーバーは次の 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"
  }
}

インストール

1. リポジトリをクローンします。

   git clone https://github.com/yourusername/perplexity-mcp-server.git
   cd perplexity-mcp-server

2. 依存関係をインストールします:

   npm install

3. .envファイルを作成します:

   PERPLEXITY_API_KEY=your-api-key-here

4. プロジェクトをビルドします。

   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 プロトコルを実装します。

建築

コアコンポーネント

1. PerplexityServer クラス

   • MCPサーバープロトコルを実装

   • ツールの登録と実行を処理する

   • エラー処理とサーバーのライフサイクルを管理します

2. ツールシステム

   • モジュラーツールの定義

   • 型安全なツールハンドラー

   • 構造化された入力検証

技術的な詳細

• 型安全性のためにTypeScriptで構築

• MCP実装には@modelcontextprotocol/sdkを使用します

• stdioトランスポート経由で通信する

• 環境ベースの構成

エラー処理

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

• APIエラー報告

• 無効なツール要求の処理

• 接続エラー管理

• プロセス信号処理

依存関係

• @modelcontextprotocol/sdk : ^1.0.3

• dotenv :^16.4.7

• isomorphic-fetch : ^3.0.0

貢献

1. リポジトリをフォークする

2. 機能ブランチを作成します（ git checkout -b feature/amazing-feature ）

3. 変更をコミットします ( git commit -m 'Add some amazing feature' )

4. ブランチにプッシュする ( git push origin feature/amazing-feature )

5. プルリクエストを開く

安全

• APIキーは環境変数を通じて管理されます

• すべてのツールパラメータの入力検証

• エラーメッセージは出力前にサニタイズされます

• MCPプロトコルによるプロセス分離

ライセンス

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

トラブルシューティング

よくある問題と解決策:

1. サーバーが見つかりません

   • claude_desktop_config.jsonのパスが正しいことを確認します

   • サーバーがビルドされていることを確認する（ npm run build ）

   • Node.jsがPATHにあるか確認する

2. 認証エラー

   • .env で Perplexity API キーを確認します

   • APIキーに必要な権限があるか確認する

3. ツール実行エラー

   • ツールパラメータがスキーマと一致していることを確認する

   • ネットワーク接続を確認する

   • 詳細なエラーメッセージについてはサーバーログを確認してください