Perplexity AI MCP Server 使用说明

项目简介

Perplexity AI MCP Server 是一个实现了 Model Context Protocol (MCP) 的服务器，它充当了 MCP 客户端和 Perplexity AI API 之间的桥梁。该服务器将 Perplexity AI 的搜索、聊天和知识检索能力封装成标准化的 MCP 工具，使得任何兼容 MCP 的 LLM 客户端都能够轻松调用 Perplexity AI 的服务。

主要功能点

集成 Perplexity AI API: 连接 Perplexity AI 的后端服务，利用其先进的语言模型和知识库。
提供多种实用工具:
- 'chat_perplexity': 与 Perplexity AI 进行对话，支持上下文聊天，保持对话历史。
- 'search': 执行通用搜索查询，获取全面的信息。
- 'get_documentation': 检索特定技术、库或 API 的文档和使用示例。
- 'find_apis': 发现和评估可集成到项目中的 API。
- 'check_deprecated_code': 检查代码或依赖项是否使用了过时的功能。
MCP 协议兼容: 使用 '@modelcontextprotocol/sdk' 构建，遵循 MCP 协议标准，易于集成到 MCP 生态系统中。
会话管理: 支持管理与 Perplexity AI 的多轮对话，通过 'chat_id' 区分不同会话。

安装步骤

安装 Node.js 和 npm: 确保你的系统上已安装 Node.js 和 npm。你可以从 Node.js 官网下载并安装。

克隆仓库: 使用 git 命令克隆 Perplexity AI MCP Server 仓库到本地：

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

安装依赖: 在项目根目录下运行 npm 命令安装项目依赖：
```
npm install
```
配置 API 密钥: 你需要拥有 Perplexity AI API 的密钥。获取密钥后，将其设置为环境变量 'PERPLEXITY_API_KEY'。例如，在 Linux/macOS 系统中，你可以使用以下命令设置环境变量（建议将此命令添加到你的 shell 配置文件中，如 '.bashrc' 或 '.zshrc'）：
```
export PERPLEXITY_API_KEY="YOUR_PERPLEXITY_API_KEY"
```
在 Windows 系统中，你可以在“系统属性” -> “高级” -> “环境变量” 中设置系统环境变量。
启动服务器: 在项目根目录下运行 npm 命令启动 MCP 服务器：
```
npm start
```
服务器成功启动后，你会在控制台看到 "Perplexity MCP server running on stdio" 的提示信息。

服务器配置

以下 JSON 配置信息可用于 MCP 客户端连接 Perplexity AI MCP Server。请注意，'command' 和 'args' 字段需要根据你的实际环境进行调整，确保 MCP 客户端能够正确启动并连接到服务器。

{
  "serverName": "perplexity-server",
  "command": "node",
  "args": ["index.js"],
  "transport": "stdio"
}

配置参数说明:

'serverName': 服务器名称，用于在 MCP 客户端中标识该服务器，此处为 "perplexity-server"。
'command': 启动服务器的命令，这里使用 'node' 命令来执行 JavaScript 代码。
'args': 传递给 'command' 的参数，'index.js' 是服务器的入口文件。
'transport': MCP 客户端与服务器通信的传输协议，这里使用 'stdio' (标准输入输出)。

注意:

确保你的 MCP 客户端支持 'stdio' 传输协议。
MCP 客户端需要能够找到 'node' 命令以及 'index.js' 文件所在的路径。如果 'node' 不在系统的 PATH 环境变量中，你需要提供 'node' 的完整路径。如果 'index.js' 不在 MCP 客户端的工作目录下，你需要根据实际情况调整 'args' 中的路径。

基本使用方法

启动 MCP 客户端: 确保你已经安装并配置了兼容 MCP 协议的 LLM 客户端。
配置服务器连接: 在 MCP 客户端中，根据上述提供的服务器配置信息，添加 Perplexity AI MCP Server 的连接配置。
调用工具: 在 LLM 客户端中，你可以通过指定工具名称和参数来调用 Perplexity AI MCP Server 提供的工具。例如，要使用 'search' 工具进行搜索，你可以构造一个包含 'tool_call' 的请求，指定 'name' 为 "search"，并在 'arguments' 中提供 'query' 参数。

具体的工具调用方法和参数格式，请参考 MCP 协议文档以及你所使用的 MCP 客户端的文档。

示例 (MCP 客户端请求 - 假设客户端支持 JSON 格式请求):

{
  "jsonrpc": "2.0",
  "method": "call_tool",
  "params": {
    "name": "search",
    "arguments": {
      "query": "最新的自然语言处理技术"
    }
  },
  "id": "123"
}

MCP 服务器将会处理这个请求，调用 Perplexity AI API 进行搜索，并将结果以 MCP 响应格式返回给客户端。

更详细的 MCP 协议和工具使用方法，请参考 Model Context Protocol 官方文档。

关键词