产品定位
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 密钥？可以通过命令行参数或环境变量配置。
- 如何选择查询类型？简单查询适用于快速、低成本的问题，复杂查询适用于需要详细推理的问题。
- 如何包含文件附件？在查询中提供文件的绝对路径。
使用教程
使用依赖
安装前置依赖：
bash
uv sync
安装教程
通过 Smithery 自动安装：
bash
npx -y @smithery/cli install @code-yeongyu/perplexity-advanced-mcp --client claude
使用 uvx 快速启动：
sh
uvx perplexity-advanced-mcp -o <openrouter_api_key> # 或 -p <perplexity_api_key>
调试方式
配置环境变量：
```sh
export OPENROUTER_API_KEY="your_key_here"
或
export PERPLEXITY_API_KEY="your_key_here"
uvx perplexity-advanced-mcp
```
