Perplexity Ask OpenRouter

Perplexity Ask OpenRouter

Perplexity Ask で OpenRouter を利用できるようにする、Model Context Protocol（MCP）サーバーの実装です。

概要

このプロジェクトは、Perplexity Askに着想を得ており、OpenRouter の API に接続する MCP サーバーを実装しています。MCP 互換のクライアントであれば、OpenRouter 経由で Perplexity のモデルを利用できます。

機能

• Model Context Protocol の完全な実装
• OpenRouter 経由で Perplexity のモデルをサポート：
  • perplexity_ask - 一般的な問い合わせに Sonar モデルを使用
  • perplexity_research - 詳細な調査に Sonar Deep Research モデルを使用
  • perplexity_reason - 複雑な推論タスクに Sonar Reasoning モデルを使用
• Server-Sent Events（SSE）をサポート
• ストリーマブル HTTP トランスポートを実装
• 簡単にデプロイできる Docker コンテナ化

はじめに

環境変数

サーバーには次の環境変数が必要です：

• OPENROUTER_API_KEY - OpenRouter API キー（必須）
• PORT - サーバーを実行するポート（デフォルト：3000）
• BASE_URL - カスタム OpenRouter ベース URL（任意）
• ASK_MODEL - ask ツールで使用するモデル（デフォルト：perplexity/sonar-pro）
• RESEARCH_MODEL - research ツールで使用するモデル（デフォルト：perplexity/sonar-deep-research）
• REASON_MODEL - reason ツールで使用するモデル（デフォルト：perplexity/sonar-reasoning-pro）
• DISABLE_ASK - ask ツールを無効にする（デフォルト：false）
• DISABLE_RESEARCH - research ツールを無効にする（デフォルト：false）
• DISABLE_REASON - reason ツールを無効にする（デフォルト：false）

Docker で実行する

サーバーを実行する最も簡単な方法は Docker を使用することです：

docker run -p 3000:3000 \
  -e OPENROUTER_API_KEY=your_api_key_here \
  ghcr.io/elct9620/perplexity-ask-openrouter:latest

ソースからビルドする

ソースからビルドする場合：

# Clone the repository
git clone https://github.com/elct9620/perplexity-ask-openrouter.git
cd perplexity-ask-openrouter

# Build Docker image
docker build -t perplexity-ask-openrouter .

API エンドポイント

サーバーは次のエンドポイントを公開します：

• /sse - 接続を確立するための SSE エンドポイント
• /messages - 確立済みの SSE 接続にメッセージを送信するためのエンドポイント
• /mcp - MCP プロトコルを実装するストリーマブル HTTP エンドポイント

MCP クライアントでの使用

このサーバーは Model Context Protocol を実装しているため、MCP 互換のクライアントであればどれでも使用できます。SSE とストリーマブル HTTP の両方のトランスポートモードをサポートしています。

Docker でのデプロイ

このプロジェクトには、Docker イメージをビルドして GitHub Container Registry（ghcr.io）に公開するための Dockerfile と GitHub Actions ワークフローが含まれています。

ライセンス

MIT ライセンス