一款模型上下文协议（MCP）服务器，利用 Perplexica 的 AI 驱动搜索引擎提供搜索功能。

特色

• 搜索工具：AI驱动的多种来源类型搜索（网页、学术、讨论）
• 多传输支持：stdio、SSE和可流式HTTP传输
• FastMCP 集成：使用 FastMCP 构建，以实现强健的 MCP 协议合规性
• 统一架构：支持所有传输模式的单一服务器实现
• 生产准备：支持Docker及安全最佳实践

开发环境

给Claude代码用户

重要：如果您使用Claude代码进行开发，本项目要求所有开发操作均使用container-use的MCP服务器。所有文件操作、代码变更和shell命令必须在容器使用环境中执行。

使用容器使用（仅限Claude代码）

使用Claude代码参与本项目时，您必须：

1. 仅使用容器使用：所有文件操作、代码编辑和shell命令必须使用容器使用环境完成
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