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. 提供具体细节