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" } }

インストール

リポジトリをクローンします。
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キーに必要な権限があるか確認する
ツール実行エラー
- ツールパラメータがスキーマと一致していることを確認する
- ネットワーク接続を確認する
- 詳細なエラーメッセージについてはサーバーログを確認してください