perplexity-polza-mcp-server

Polza.ai 経由の Perplexity MCP サーバー

mcp-name: io.github.ivanantigravity-lgtm/perplexity-polza-mcp-server

Claude Desktop と Claude Code 向けの MCP サーバーです。アグリゲーター Polza.ai 経由で Perplexity のモデル（Sonar、Sonar Pro、Sonar Reasoning、Sonar Deep Research）を利用できます。

できること

• perplexity_model_guide — タスクに応じたモデル選びの早見表
• perplexity_ask — Perplexity への通常の質問
• perplexity_research — ウェブ検索を使った、より詳細なリサーチ
• list_perplexity_models — Polza のカタログにある利用可能な perplexity/* モデルの一覧

インストールに必要なもの

• Claude Desktop、Claude Code（またはその他の MCP クライアント）
• uv（以下の手順で、1 つのコマンドでインストールできます）
• Python 3.11+
• POLZA_AI_API_KEY — polza.ai/dashboard/api-keys で取得できるキー

uv のインストール：

curl -LsSf https://astral.sh/uv/install.sh | sh

2 分でインストール（PyPI + uvx を使用）

最も簡単な方法です。リポジトリをクローンする必要はなく、uvx が PyPI からパッケージをダウンロードします。

Claude Code / VS Code

プロジェクトのルートに .mcp.json ファイルを作成します。

{
  "mcpServers": {
    "perplexity-polza": {
      "command": "uvx",
      "args": ["perplexity-polza-mcp-server@latest"],
      "env": {
        "POLZA_AI_API_KEY": "your-polza-api-key-here"
      }
    }
  }
}

Claude Code を再起動すれば完了です。

Claude Desktop（macOS）

~/Library/Application Support/Claude/claude_desktop_config.json ファイルを開き、次の内容を追加します。

{
  "mcpServers": {
    "perplexity-polza": {
      "command": "uvx",
      "args": ["perplexity-polza-mcp-server@latest"],
      "env": {
        "POLZA_AI_API_KEY": "your-polza-api-key-here"
      }
    }
  }
}

Claude Desktop を再起動します。

Claude Desktop（Windows）

ファイル：%APPDATA%\Claude\claude_desktop_config.json。内容は macOS と同じです。

動作確認

Claude の再起動後、次のように頼みます。

polza 経由で利用可能な Perplexity のモデルを表示してください

Claude が list_perplexity_models ツールを呼び出し、一覧を返します。

モデルの選び方

• Sonar — 高速な検索と回答。ニュース、事実確認、Q&A、短い要約に適しています。
• Sonar Pro — より緻密な構成、比較、追加質問に適しています。
• Sonar Pro Search — より詳細な検索で、検索ステップ数も増えます。
• Sonar Reasoning Pro — ただ情報を見つけるだけでなく、分析して結論を導きます。
• Sonar Deep Research — 本格的なリサーチ、市場調査、長文レポートに適しています。

デフォルトモデルは環境変数 PERPLEXITY_MODEL と PERPLEXITY_RESEARCH_MODEL で切り替えられます。モデルの全一覧は以下をご覧ください。

環境変数

変数	必須	デフォルト	説明
POLZA_AI_API_KEY	はい	—	polza.ai のキー
POLZA_BASE_URL	いいえ	https://polza.ai/api/v1	チャット補完用のベース URL（/v1 が含まれるのは想定どおりです。エンドポイントは OpenAI 互換です）
PERPLEXITY_MODEL	いいえ	perplexity/sonar	perplexity_ask に使用するモデル
PERPLEXITY_RESEARCH_MODEL	いいえ	perplexity/sonar-deep-research	perplexity_research に使用するモデル
LOG_LEVEL	いいえ	INFO	—

ローカル開発

git clone https://github.com/ivanantigravity-lgtm/perplexity-polza-mcp-server.git
cd perplexity-polza-mcp-server
uv sync
POLZA_AI_API_KEY=your_key uv run python -m perplexity_polza_mcp_server.server

ソースから Claude にローカル接続するには：

{
  "mcpServers": {
    "perplexity-polza-local": {
      "command": "uv",
      "args": ["run", "python", "-m", "perplexity_polza_mcp_server.server"],
      "cwd": "/absolute/path/to/perplexity-polza-mcp-server",
      "env": {
        "POLZA_AI_API_KEY": "your-polza-api-key-here"
      }
    }
  }
}

内部の仕組み

• チャット補完：POST https://polza.ai/api/v1/chat/completions（OpenAI 互換形式）
• モデルカタログ：GET https://polza.ai/api/v1/models/catalog

リポジトリ内の重要なファイル

• pyproject.toml — パッケージのメタデータとエントリーポイント
• server.json — MCP Registry 用の説明
• fastmcp.json — FastMCP のローカル設定
• .github/workflows/publish-pypi.yml — GitHub Actions を使った PyPI への公開

ライセンス

MIT。