Perplexity Web Search

🚀 perplexity 网络搜索 MCP 服务器

这是一个简单的 MCP（模型上下文协议）服务器，借助 Perplexity API 实现网络搜索功能。该服务器能让 Claude 或其他兼容 MCP 的 AI 助手开展网络搜索，获取最新信息。

✨ 主要特性

• 借助 Perplexity 强大的搜索能力进行网络搜索。
• 获取全面的搜索结果，包含来源和引用。
• 可按时间范围（天、周、月、年）过滤结果。
• 提供现成的网络搜索提示模板。
• 支持从环境变量或 .env 文件加载 API 密钥。

📦 安装指南

1. 克隆此仓库。
2. 安装依赖：

   pip install -e .
   

   或者

   uv pip install -e .
   

📚 详细文档

配置

你可以设置 PERPLEXITY_API_KEY 环境变量，使用你的 Perplexity API 密钥：

export PERPLEXITY_API_KEY="your-api-key-here"

或者创建项目根目录中的 .env 文件，包含以下内容：

PERPLEXITY_API_KEY=your-api-key-here

提供了一个示例 .env.example 文件供参考。

获取 Perplexity API 密钥：

1. 访问 Perplexity API 设置。
2. 如果没有账户则创建一个。
3. 生成 API 密钥。

使用方法

运行服务器

python server.py

测试服务器功能

可以使用包含的测试脚本在不运行完整的 MCP 服务器的情况下测试服务器功能：

python test_server.py "your search query here" --recency month

--recency 的选项有：day, week, month (默认), year。

集成到 Claude Desktop 中

1. 编辑你的 Claude Desktop 配置文件：
   • 在 macOS 上：~/Library/Application\ 支持/Claude/claude_desktop_config.json。
   • 在 Windows 上：%APPDATA%/Claude/claude_desktop_config.json。
2. 添加以下配置：

   {
     "perplexity-mcp": {
       "env": {
         "PERPLEXITY_API_KEY": "your-api-key-here"
       },
       "command": "python",
       "args": [
         "/path/to/server.py"
       ]
     }
   }
   

3. 重启 Claude Desktop。

示例提示语（供 Claude 使用）

• “搜索有关人工智能最新新闻的网络信息”
• “使用 Perplexity 查找过去一周关于气候变化的信息”
• “搜索过去一个月量子计算方面的最新研究论文”

📄 API 文档

工具：search_web(query: str, recency: str = "month") -> str

使用 Perplexity API 搜索网络并返回结果。

参数：

• query：搜索查询字符串。
• recency：按时间段过滤结果 - 'day', 'week', 'month' (默认), 或 'year'。

返回值： 一个全面的文本响应，包含：

1. 搜索结果的详细摘要。
2. 关键事实和信息。
3. 来源 URL 用于验证。
4. 如果有的话，任何冲突的信息。

提示语：web_search_prompt(query: str, recency: str = "month") -> str

创建一个提示模板，用于使用 Perplexity 进行网络搜索。

参数：

• query：搜索查询。
• recency：时间范围过滤器 - 'day', 'week', 'month' (默认), 或 'year'。

返回值： 一个格式化的提示字符串，指示 AI：

1. 搜索指定的查询。
2. 焦点在指定的时间段内的结果上。
3. 总结关键发现。
4. 指出信息的重要性。
5. 提供具体细节。