Perplexity Web Search MCP Server

Perplexity Web Search MCP Server

一个简单的 MCP（Model Context Protocol）服务，使用 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\ 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