使用说明

项目简介

'mcp-perplexity-server' 是一个基于 Model Context Protocol (MCP) 的服务器实现，它将 Perplexity AI 的强大搜索功能封装成一个名为 'search_web' 的工具，供支持 MCP 协议的 LLM 客户端调用。通过此服务器，LLM 应用可以方便地利用 Perplexity AI 进行网页搜索、信息检索等操作，从而增强其处理复杂任务的能力。

主要功能点

网页搜索工具 (search_web): 允许 LLM 客户端通过发送结构化的请求，调用 Perplexity AI 进行网页搜索。
- 支持指定搜索类型 ('research', 'troubleshoot', 'update')，以优化搜索结果。
- 支持设置搜索复杂度 ('low', 'medium', 'high')，以控制搜索模型的选择。
标准 MCP 服务器: 遵循 MCP 协议规范，易于与各种支持 MCP 协议的 LLM 客户端集成。
基于 Stdio 传输: 使用标准输入输出 (stdio) 作为通信协议，简化部署和集成过程。

安装步骤

安装 Node.js 和 npm: 确保您的系统已安装 Node.js 和 npm (Node Package Manager)。

克隆仓库: 使用 Git 克隆 'mcp-perplexity-server' 仓库到本地：

git clone https://github.com/dkmaker/mcp-perplexity-server.git

进入项目目录: 切换到克隆下来的项目目录：

cd mcp-perplexity-server

安装依赖: 使用 npm 安装项目所需的依赖包：
```
npm install
```
构建项目: 使用 npm 构建 TypeScript 代码：
```
npm run build
```
设置 Perplexity API 密钥: 您需要在运行服务器之前设置 Perplexity API 密钥。请访问 Perplexity AI 开发者平台获取 API 密钥，并将其设置为名为 'PERPLEXITY_API_KEY' 的环境变量。例如，在 Linux 或 macOS 系统中，您可以使用以下命令设置环境变量：
```
export PERPLEXITY_API_KEY=YOUR_API_KEY
```
在 Windows 系统中，您可以在系统环境变量中设置。

服务器配置

要将此 MCP 服务器与 MCP 客户端（如 Claude Desktop）配合使用，您需要在客户端的配置文件中添加服务器配置信息。以下是一个 'claude_desktop_config.json' 示例配置：

{
  "mcpServers": {
    "perplexity-server": {
      "command": "/path/to/perplexity-server/build/index.js"
    }
  }
}

配置说明:

'"perplexity-server"': 服务器名称，您可以自定义，用于在客户端中标识此服务器。
'"command"': 重要: 这是 MCP 客户端启动 MCP 服务器时执行的命令。您需要将 '/path/to/perplexity-server/build/index.js' 替换为 您本地 'perplexity-server' 项目构建后 'index.js' 文件的实际绝对路径。例如，如果您的项目位于用户主目录下的 'mcp-perplexity-server' 文件夹中，则路径可能类似于 '/Users/yourusername/mcp-perplexity-server/build/index.js' (macOS/Linux) 或 'C:\Users\YourUsername\mcp-perplexity-server\build\index.js' (Windows)。请务必根据您的实际项目路径进行修改。

基本使用方法

启动 MCP 客户端: 配置完成后，启动您的 MCP 客户端（如 Claude Desktop）。客户端将根据配置文件自动启动 'perplexity-server'。
在 LLM 中使用 'search_web' 工具: 在您的 LLM 客户端中，您可以通过指令或特定语法调用 'search_web' 工具，并传递相应的参数（例如 'query'，'type'，'complexity'）来执行网页搜索。具体的调用方式请参考您的 LLM 客户端的使用文档。

调试

如果遇到问题，可以使用仓库 'README.md' 中提到的 MCP Inspector 工具进行调试。

关键词

使用说明

信息