Perplexity Web Search MCP 服务器

一个简单的 MCP (模型上下文协议) 服务器，它使用 Perplexity API 提供网络搜索功能。此服务器允许 Claude 或其他兼容 MCP 的 AI 助手搜索网络并获取最新的信息。

功能

• 使用 Perplexity 强大的搜索功能搜索网络
• 获取包含来源和引用的全面搜索结果
• 按时间段（天、周、月、年）过滤结果
• 包含一个即用型的网络搜索提示模板
• 支持从环境变量或 .env 文件加载 API 密钥

安装

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

   pip install -e .
   

   或者

   uv pip install -e .
   

配置

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

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\ Support/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. 提及冲突信息
6. 引用带有链接的来源

许可证

MIT