PerplexicaのAI搭載検索エンジンで検索機能を提供するモデルコンテキストプロトコル(MCP)サーバー。

##特徴

-Search Tool:複数のソースタイプ(ウェブ、アカデミック、ディスカッション)でAIを活用した検索

• 複数の輸送サポート: stdio、SSE、およびストリーミング可能なHTTP輸送
• FastMCPの統合: 堅牢なMCPプロトコル対応のFastMCPで構築
• 統一アーキテクチャ: すべてのトランスポートモードをサポートする単一サーバーの実装
• 生産準備:セキュリティのベストプラクティスのドッカーサポート

##開発環境

##Claudeコードユーザーのための####

重要: 開発用にClaude Code を使用する場合は、このプロジェクトでは、すべての開発操作で [container-use MCP サーバーを使用する必要があります。 すべてのファイル操作、コード変更、シェルコマンドはコンテナ使用環境内で実行する必要があります。

コンテナ使用(ロードコードのみ)

Claude Code を使用してこのプロジェクトに貢献する際には、次のことが必要です。

1。 コンテナを使用するだけ:コンテナ使用環境を使用して、すべてのファイル操作、コード編集、およびシェルコマンドを実行する必要があります。 2.あなたの仕事を見る: 変更後、他の人にあなたの仕事にアクセスする方法を知らせてください

Perplexica MCP Server

A Model Context Protocol (MCP) server that provides search functionality using Perplexica’s AI-powered search engine.

Features

• Search Tool: AI-powered search with multiple source types (web, academic, discussions)
• Multiple Transport Support: stdio, SSE, and Streamable HTTP transports
• FastMCP Integration: Built using FastMCP for robust MCP protocol compliance
• Unified Architecture: Single server implementation supporting all transport modes
• Production Ready: Docker support with security best practices

Development Environment

For Claude Code Users

Important: If you are using Claude Code for development, this project requires the use of the container-use MCP server for all development operations. All file operations, code changes, and shell commands must be executed within container-use environments.

Working with Container-Use (Claude Code Only)

When contributing to this project using Claude Code, you must:

1. Use Container-Use Only: All file operations, code editing, and shell commands must be performed using container-use environments
2. View Your Work: After making changes, inform others how to access your work:
   • Use container-use log to view the development log
   • Use container-use checkout to check out your environment
3. No Local Operations: Do not perform file operations directly on the local filesystem

Example Development Workflow (Claude Code)

# Create a new environment for your work
container-use create --title "Your feature description"

# Make your changes using container-use tools
# (All file operations handled by container-use)

# Share your work with others
container-use log 
container-use checkout 

This ensures consistency, reproducibility, and proper version control for all development activities when using Claude Code.

For Other Development Environments

If you are not using Claude Code, you can develop normally using your preferred tools and IDE. The container-use requirement does not apply to regular development workflows.

Installation

From PyPI (Recommended)

# Install directly from PyPI
pip install perplexica-mcp

# Or using uvx for isolated execution
uvx perplexica-mcp --help

From Source

# Clone the repository
git clone https://github.com/thetom42/perplexica-mcp.git
cd perplexica-mcp

# Install dependencies
uv sync

MCP Client Configuration

To use this server with MCP clients, you need to configure the client to connect to the Perplexica MCP server. Below are configuration examples for popular MCP clients.

Important: All transport modes require proper environment variable configuration, especially:

• PERPLEXICA_BACKEND_URL: URL to your Perplexica backend API
• PERPLEXICA_CHAT_MODEL_PROVIDER and PERPLEXICA_CHAT_MODEL_NAME: Chat model configuration