Perplexica의 AI 전원 검색 엔진을 사용하여 검색 기능을 제공하는 모델 Context Protocol (MCP) 서버.

특징

-Search Tool: 여러 소스 유형의 AI 전원 검색(웹, 학술, 토론)

• Multiple Transport Support: stdio, SSE 및 스트리밍 가능한 HTTP 전송
• **FastMCP 통합 **: 견고한 MCP 프로토콜 준수를 위한 FastMCP를 사용하여 내장
• Unified Architecture: 단일 서버 구현 지원 모든 전송 모드 -Production Ready: 보안 모범 사례와 Docker 지원

개발 환경

for Claude 코드 사용자

** 중요 **: 개발용 Claude Code를 사용하는 경우, 이 프로젝트는 모든 개발 작업에 대한 container-use MCP 서버의 사용을 요구합니다. 모든 파일 작업, 코드 변경 및 쉘 명령은 컨테이너 사용 환경에서 실행되어야 합니다.

컨테이너 사용 작업 (Claude Code Only)

Claude Code를 사용하여이 프로젝트에 기여할 때 다음을 수행해야 합니다.

1.Use Container-Use Only: 모든 파일 작업, 코드 편집 및 쉘 명령은 컨테이너 사용 환경을 사용하여 수행되어야 합니다. 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