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\ Support/Claude/claude_desktop_config.json
   • Windows 系统：%APPDATA%/Claude/claude_desktop_config.json

2. 添加以下配置：

   json 复制代码

   {
     "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