使用说明

项目简介

perplexity-server 是一个基于 Model Context Protocol (MCP) 的服务器实现，它将 Perplexity AI 的强大搜索能力封装成一个易于集成的工具，供支持 MCP 协议的 LLM 客户端（如 Claude Desktop）调用。通过此服务器，LLM 应用可以方便地利用 Perplexity AI 进行联网搜索，获取最新的信息和网络引用。

主要功能点

联网搜索工具: 提供名为 'search' 的工具，允许 LLM 客户端通过 Perplexity AI 执行联网搜索。
参数可配置: 'search' 工具支持多种参数配置，如搜索关键词、模型选择、最大 token 数、温度系数和搜索时间范围等，以满足不同的搜索需求。
结构化返回: 工具返回结构化的 JSON 响应，包含搜索结果的答案、引用的网页链接以及 token 使用统计信息。
易于集成: 遵循 MCP 协议标准，可以方便地与各种支持 MCP 协议的 LLM 客户端集成。
错误处理: 具备完善的错误处理机制，能够处理 API 密钥缺失、参数错误、API 速率限制和网络问题等常见错误。

安装步骤

前提条件:
- 拥有 Perplexity API 密钥 (获取地址: https://www.perplexity.ai/settings)
- 安装了 Node.js 和 npm (或 yarn)

下载仓库代码:

git clone https://github.com/alexwohletz/perplexity-server.git
cd perplexity-server

安装依赖:
```
npm install
```
构建服务器:
```
npm run build
```

服务器配置

要将 perplexity-server 集成到 MCP 客户端（例如 Claude Desktop），您需要配置客户端以连接到此服务器。以下是 Claude Desktop 的配置示例，您需要将以下 JSON 配置添加到 Claude Desktop 的配置文件中。

配置文件路径：

MacOS: '~/Library/Application Support/Claude/claude_desktop_config.json'
Linux: '~/.vscode-server/data/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json'
Windows: '%APPDATA%/Claude/claude_desktop_config.json'

配置内容 (请根据实际情况修改路径和API密钥):

{
  "mcpServers": {
    "perplexity": {
      "command": "node",
      "args": ["/path/to/perplexity-server/build/index.js"],
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key-here"
      }
    }
  }
}

参数说明:

'"perplexity"': 服务器名称，可以自定义，用于在客户端中标识该服务器。
'"command": "node"': 启动服务器的命令，这里使用 Node.js 运行。
'"args": ["/path/to/perplexity-server/build/index.js"]': 启动命令的参数，指向编译后的服务器入口文件 'index.js' 的绝对路径。请将 '/path/to/perplexity-server' 替换为您本地 perplexity-server 仓库的实际路径。
'"env": { "PERPLEXITY_API_KEY": "your-api-key-here" }': 环境变量配置，用于设置 Perplexity API 密钥。请将 '"your-api-key-here"' 替换为您在 Perplexity AI 官网申请的 API 密钥。

基本使用方法

perplexity-server 作为 MCP 服务器，主要通过 MCP 客户端进行调用。您无需直接操作该服务器。

配置完成后，在支持 MCP 协议的 LLM 客户端中，您就可以使用 'perplexity' 服务器提供的 'search' 工具进行联网搜索了。

例如，在 Claude Desktop 中，您可以通过指令或者自然语言触发工具调用，例如：

使用 perplexity search 工具搜索 “量子计算是什么？”

客户端会将请求发送到 perplexity-server，服务器调用 Perplexity AI API 进行搜索，并将结果返回给客户端，最终呈现给用户。

关键词