项目简介

本项目是一个基于 Model Context Protocol (MCP) 的服务器实现，它利用 Perplexity API 提供网络搜索能力。通过此服务器，兼容 MCP 协议的 AI 助手可以调用 'search' 工具进行网页搜索，获取最新的信息，并能根据时间范围过滤搜索结果。

主要功能点

网络搜索: 使用 Perplexity API 执行高质量的网络搜索。
时间过滤: 支持按月份、周、天、小时过滤搜索结果，获取更近期的信息。
MCP 协议兼容: 无缝集成到任何支持 MCP 协议的 AI 助手平台。
工具注册: 向 MCP 客户端声明并提供 'search' 工具。

安装步骤

克隆仓库:

git clone https://github.com/Viktor-berg5061/perplexity-serch-v2.git
cd perplexity-serch-v2

安装依赖:
```
npm install
```

配置 Perplexity API 密钥:

方法一：创建 '.env' 文件 (推荐): 在项目根目录下创建 '.env' 文件，并添加你的 Perplexity API 密钥：
```
PERPLEXITY_API_KEY=你的_Perplexity_API_密钥
```
请前往 Perplexity AI 获取 API 密钥。

方法二：设置环境变量: 在你的终端中设置 'PERPLEXITY_API_KEY' 环境变量：

export PERPLEXITY_API_KEY=你的_Perplexity_API_密钥

服务器配置 (MCP 客户端设置)

要将此服务器添加到 MCP 客户端的配置中，你需要提供以下 JSON 配置信息。客户端会使用这些信息来启动和连接到 Perplexity 搜索 MCP 服务器。

{
  "mcpServers": {
    "perplexity-search-v2": {  // 服务器名称，客户端用于标识和引用
      "command": "node",        // 启动服务器的命令，这里使用 Node.js 解释器
      "args": ["path/to/perplexity-serch-v2/index.js"], // 启动命令的参数，指向服务器入口文件 index.js，请替换 "path/to/perplexity-serch-v2" 为你的实际项目路径
      "env": {                 // 环境变量配置
        "PERPLEXITY_API_KEY": "你的_Perplexity_API_密钥" //  Perplexity API 密钥，建议在 .env 文件中配置，此处仅为示例
      },
      "disabled": false,        // 是否禁用此服务器，false 表示启用
      "autoApprove": []        // 自动允许客户端调用的工具列表，空数组表示需要用户手动授权
    }
  }
}

注意:

请将 'path/to/perplexity-serch-v2/index.js' 替换为 'index.js' 文件在你电脑上的实际路径。例如，如果你的项目放在用户目录下的 'Documents/mcp-servers/perplexity-serch-v2' 文件夹中，那么路径可能类似于 '/Users/你的用户名/Documents/mcp-servers/perplexity-serch-v2/index.js' (macOS/Linux) 或 'C:\Users\你的用户名\Documents\mcp-servers\perplexity-serch-v2\index.js' (Windows)。
'PERPLEXITY_API_KEY' 建议通过 '.env' 文件或环境变量配置，避免直接写在 JSON 配置文件中。

基本使用方法

启动服务器: 在项目根目录下，运行以下命令启动 MCP 服务器：
```
npm start
```
或者
```
node index.js
```
服务器成功启动后，会在终端输出 "Perplexity Search MCP server running on stdio"。
在 MCP 客户端中使用: 配置好 MCP 客户端并添加上述服务器配置后，AI 助手即可通过 'search' 工具进行网络搜索。例如，在支持自然语言工具调用的 AI 助手界面中，你可以指示 AI 助手使用 "search" 工具来查找信息。

'search' 工具接受以下参数：
- 'query' (必填): 搜索关键词或问题。
- 'search_recency_filter' (可选): 时间过滤器，可选值包括 'month' (最近一个月), 'week' (最近一周), 'day' (最近一天), 'hour' (最近一小时)。
例如，你可以指示 AI 助手执行类似 "使用 search 工具搜索 '最新的 AI 技术发展' " 的指令。如果需要指定时间范围，可以类似 "使用 search 工具搜索 '昨天发布的关于气候变化的新闻'，并使用时间过滤器 'day'"。

关键词

项目简介

主要功能点

安装步骤

服务器配置 (MCP 客户端设置)

基本使用方法

信息