网络搜索服务

困惑网络搜索MCP服务器

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

特性

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

安装

1. 克隆此存储库
2. 安装依赖项：
   复制

   pip install -e .
   

   或
   复制

   uv pip install -e .
   

配置

您可以设置 PERPLEXITY_API_KEY 环境变量与您的困惑API密钥：

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

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

PERPLEXITY_API_KEY=your-api-key-here

样品 .env.example 文件仅供参考。

获取困惑API密钥：

1. 访问 困惑API设置
2. 如果您没有帐户，请创建一个帐户
3. 生成API密钥

用法

运行服务器

python server.py

测试服务器

您可以使用附带的测试脚本测试服务器功能，而无需运行完整的MCP服务器：

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

选项 --recency 包括：日、周、月（默认）、年

与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. 重新启动克劳德桌面

克劳德提示示例

• “在网上搜索有关人工智能的最新消息”
• “使用困惑查找过去一周发布的气候变化信息”
• “搜索过去一个月关于量子计算的最新研究论文”

api参考

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

使用困惑API搜索网页并返回结果。

参数：

• query：搜索查询字符串
• recency：按时间段筛选结果-“天”、“周”、“月”（默认）或“年”

退货： 一份全面的文本回复，其中包含：

1. 搜索结果的详细摘要
2. 发现的关键事实和信息
3. 带有URL以供验证的来源
4. 如果存在任何冲突信息

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

创建一个提示模板，用于使用困惑搜索网络。

参数：

• query：搜索查询
• recency：时间段筛选器-“天”、“周”、“月”（默认）或“年”

退货： 一个格式化的提示字符串，指示AI：

1. 搜索指定的查询
2. 关注指定时间段的结果
3. 总结主要发现
4. 突出重要事实
5. 提及相互冲突的信息
6. 引用带有链接的来源

许可证

麻省理工学院