Overview

产品定位

Perplexity Advanced MCP 是一个高级集成包，旨在通过 OpenRouter 和 Perplexity API 提供增强的查询处理能力，适用于开发者和 AI 助手集成。

核心功能

• 多供应商支持：支持 Perplexity 和 OpenRouter API，提供灵活的供应商选择。
• 查询类型优化：区分简单和复杂查询，优化成本和性能。
• 文件附件支持：允许在查询中包含文件内容作为上下文，提供更精确的响应。
• 增强的重试逻辑：实现健壮的重试机制，提高可靠性。
• 统一 API 客户端：支持配置不同模型处理简单和复杂查询。
• 命令行界面 (CLI)：使用 Typer 管理 API 密钥配置和运行 MCP 服务器。
• 自定义日志记录：灵活的日志配置，便于调试和运行时监控。

适用场景

• 与 AI 助手（如 Cursor、Claude for Desktop）集成。
• 处理需要互联网搜索的复杂查询。
• 需要文件附件作为上下文的查询场景。
• 开发者在代码库中集成高级查询功能。

工具列表

• ask_perplexity：支持简单和复杂查询，处理文件附件提供上下文。
• uvx：用于快速启动 MCP 服务器。
• Smithery：自动安装 Perplexity Advanced MCP。

常见问题解答

• 如何配置 API 密钥？可以通过命令行参数或环境变量配置。
• 如何选择查询类型？简单查询适用于快速、低成本的问题，复杂查询适用于需要详细推理的问题。
• 如何包含文件附件？在查询中提供文件的绝对路径。

使用教程

使用依赖

安装前置依赖：

uv sync

安装教程

通过 Smithery 自动安装：

npx -y @smithery/cli install @code-yeongyu/perplexity-advanced-mcp --client claude

使用 uvx 快速启动：

uvx perplexity-advanced-mcp -o <openrouter_api_key> # 或 -p <perplexity_api_key>

调试方式

配置环境变量：

export OPENROUTER_API_KEY="your_key_here"
# 或
export PERPLEXITY_API_KEY="your_key_here"

uvx perplexity-advanced-mcp

许可证

该项目遵循 MIT 开源许可条款。