使用说明

项目简介

Perplexity MCP Server 是一个实现了 Model Context Protocol 的服务器，它利用 Perplexity 的 AI 驱动的互联网搜索 API，为 AI 助手提供互联网搜索能力。通过此服务器，AI 助手可以执行互联网搜索，并获得包含来源引用的 AI 增强答案。

主要功能点

提供互联网搜索功能，返回AI增强的答案。
答案包含来源引用，方便用户追溯信息来源。
可以配置搜索结果的域名过滤，缩小搜索范围。
支持详细的日志记录，方便问题排查和监控服务器运行状态。
实现了 MCP 协议，可以与兼容 MCP 协议的客户端通信，作为 LLM 应用的上下文服务。

安装步骤

确保已安装 pnpm。如果未安装，请先安装 pnpm。

克隆 GitHub 仓库到本地：

git clone https://github.com/martinbechard/mcp-perplexity.git
cd mcp-perplexity

安装项目依赖：
```
pnpm install
```
构建项目：
```
pnpm build
```

服务器配置

要将此服务器配置到 MCP 客户端（例如 Claude Desktop），您需要在客户端的配置文件中添加以下 JSON 配置。请根据您的实际安装路径和 Perplexity API 密钥进行修改。

{
  "mcpServers": {
    "perplexity": {
      "command": "node",
      "args": [
        "/path/to/your/dev/mcp-perplexity/dist/stdio-server.js",
        "--api-key",
        "YOUR_PERPLEXITY_API_KEY"
      ]
    }
  }
}

配置参数说明:

'server name': 'perplexity' (服务器名称，客户端用此名称标识服务器)
'command': 'node' (启动服务器的命令，确保您的环境中 'node' 命令可用)
'args': 启动参数，以数组形式提供
- '/path/to/your/dev/mcp-perplexity/dist/stdio-server.js': MCP 服务器 'stdio-server.js' 脚本的绝对路径。请务必替换为实际的本地仓库路径。
- '--api-key': 'YOUR_PERPLEXITY_API_KEY' (Perplexity API 密钥)。请替换为您在 Perplexity 平台申请的实际 API 密钥。您也可以选择将 API 密钥设置为环境变量 'PERPLEXITY_API_KEY'，在这种情况下，'args' 中可以省略 '--api-key' 参数。

注意: 请根据您的操作系统和实际文件路径，调整 'command' 和 'args' 中的配置。对于 Claude Desktop 等 MCP 客户端，请参考其官方文档，找到正确的配置文件位置进行配置。

基本使用方法

启动服务器: 打开终端，进入 'mcp-perplexity' 仓库目录，运行以下命令启动服务器，并传入 Perplexity API 密钥：
```
pnpm start --api-key YOUR_API_KEY_HERE
```
或者，如果您已设置环境变量 'PERPLEXITY_API_KEY'，则可以直接运行：
```
pnpm start
```
服务器成功启动后，将在终端输出 "Perplexity MCP Server running on stdio"。
在 MCP 客户端中使用: 配置完成后，在兼容 MCP 协议的客户端（如 Claude Desktop）中，即可选择 'perplexity' 服务器。客户端可以通过 MCP 协议调用 'perplexity_search' 工具，向服务器发送包含搜索关键词的请求。服务器将调用 Perplexity API 进行互联网搜索，并将带有 AI 增强答案和来源引用的结果返回给客户端。客户端根据 MCP 协议解析响应，并将搜索结果呈现给用户。

工具调用示例 ('perplexity_search'):

客户端可以通过 'CallToolRequest' 请求调用 'perplexity_search' 工具，请求参数 'arguments' 的 JSON 示例如下：

{
  "query": "最新的AI技术发展趋势",
  "searchDomainFilter": ["techcrunch.com", "wired.com"]
}

'query': 要搜索的关键词或问题。
'searchDomainFilter' (可选): 域名白名单，用于限制搜索结果的来源域名。

服务器会将搜索结果封装成符合 MCP 协议的 'CallToolResponse' 返回给客户端。

关键词