MCP Perplexity Server

🚀 智能コード分析とデバッグの perplexity MCP サーバー

Perplexity AI API を使用して、智能コード分析とデバッグ機能を提供する Model Context Protocol (MCP) サーバーです。Claude デスクトップクライアントとシームレスに統合されます。

✨ 主な機能

• 智能エラー分析：コーディングエラーを詳細に分解し、根本原因を分析します。
• パターン検出：一般的なエラーパターンを自動的に識別し、対策を提供します。
• 包括的な解決策：段階的な修正策を提供し、複数の実装方法を提示します。
• ベストプラクティス：コーディング標準とエラー防止のテクニックを含みます。
• Python サポート：Python の型エラーや一般的なコーディング問題を専門的に処理します。

💻 使用例

以下のような質問をしてください：

• "この TypeError をどう直せばいいですか？"
• "このエラーメッセージの原因は何ですか？"
• "このコードをどう直せばいいですか？"

対象のコードを添付することで、具体的な分析を受けることができます：

基本的な使用法

def calculate_total(items):
    total = 0
    for item in items:
        total = total + item['price']  # TypeError: string + int

data = [
    {'name': 'Book', 'price': '10'},
    {'name': 'Pen', 'price': '2'}
]

result = calculate_total(data)

サーバーは次の情報を提供します：

1. エラーの根本原因分析
2. 段階的な解決策とコード例
3. 同様の問題を防ぐためのベストプラクティス
4. 代替実装方法

📦 インストール

前提条件

• Node.js 18 以上
• Perplexity AI API キー

オプション 1: npm からインストール（推奨）

# npm を使用する場合
npm install -g perplexity-mcp

# またはリポジトリから直接インストールする場合
npm install -g git+https://github.com/yourusername/perplexity-mcp.git

オプション 2: ソースコードからインストール

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

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

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

npm install

3. ビルドしてグローバルにインストールします：

npm run build
npm install -g .

Claude デスクトップクライアントの設定

Claude デスクトップの設定ファイルに追加してください：

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "perplexity": {
      "command": "perplexity-mcp",
      "args": [],
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key-here"
      }
    }
  }
}

または、ソースコードからインストールした場合は：

{
  "mcpServers": {
    "perplexity": {
      "command": "node",
      "args": ["/absolute/path/to/perplexity-server/build/index.js"],
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key-here"
      }
    }
  }
}

🔒 セキュリティ

• API キーは Claude デスクトップの設定ファイルに安全に保存されます。
• キーは環境変数としてサーバーに渡されます。
• リポジトリには機密データは保存されません。
• サーバーは API キーを環境から取得することを想定しています。

📚 ドキュメント

プロジェクト構造

perplexity-server/
├── src/
│   └── index.ts      # メインサーバー実装ファイル
├── package.json      # プロジェクト設定ファイル
└── tsconfig.json    # TypeScript 設定ファイル

利用可能なスクリプト

• npm run build：プロジェクトをビルドします。
• npm run watch：変更を監視し、自動的に再構築します。
• npm run prepare：リリースパッケージを準備します。
• npm run inspector：MCP インスペクターを実行してデバッグします。

コントリビューションガイド

1. リポジトリをフォークします。
2. 機能ブランチを作成します (git checkout -b feature/amazing-feature)。
3. 変更をコミットします (git commit -m 'Add some amazing feature')。
4. ブランチにプッシュします (git push origin feature/amazing-feature)。
5. Pull Request を開きます。