MCP Perplexity Server

MCP Perplexity Server

site icon
2025.03.28 0
JavaScriptAPI 集成查询服务搜索服务开发效率
MCP Perplexity Server 是一个基于 Model Context Protocol (MCP) 的服务,通过 OpenAI SDK 与 Perplexity API 集成,提供查询和搜索功能。该服务支持多种传输方式,包括 STDIO 和 SSE,适用于本地和远程客户端。
View on GitHub

Overview

基本能力

产品定位

MCP Perplexity Server 是一个集成 Perplexity API 的 MCP 服务,旨在为 MCP 兼容客户端(如 Claude Desktop)提供查询和搜索功能。

核心功能

  • 与 MCP 兼容客户端集成
  • 提供两种主要工具:
  • perplexity-query:直接向 Perplexity API 发送查询
  • perplexity-search:使用 Perplexity 的搜索能力进行网络搜索
  • 支持多种传输方式:
  • STDIO 传输(本地客户端)
  • SSE 传输(远程客户端)
  • 使用 OpenAI SDK 并自定义 Perplexity API 的基础 URL
  • 提供详细的日志记录(debug、info、error 级别)

适用场景

  • 在 Claude Desktop 或其他 MCP 兼容客户端中使用 Perplexity 的查询和搜索功能
  • 需要远程访问 Perplexity API 的场景
  • 开发调试和日志记录需求

工具列表

  1. perplexity-query
  2. 功能:向 Perplexity API 发送直接查询
  3. 参数:

    • prompt(必需):查询内容
    • model(可选):使用的模型(默认 "sonar-pro")
    • systemPrompt(可选):设置查询上下文的系统提示
  4. perplexity-search

  5. 功能:使用 Perplexity 的搜索能力进行网络搜索
  6. 参数:
    • query(必需):搜索查询
    • model(可选):使用的模型(默认 "sonar-pro")

常见问题解答

  • 如何配置 Claude Desktop 使用此服务?claude_desktop_config.json 中添加 MCP 服务器配置,指定传输类型和命令路径。

  • 如何远程访问服务? 使用 SSE 传输方式,启动服务后通过 http://your-server-address:3002/sse 访问。

  • 如何调试? 服务提供详细的日志记录,可通过设置日志级别(debug、info、error)进行调试。

使用教程

使用依赖

  1. 确保已安装 Node.js 和 npm
  2. 克隆仓库并安装依赖: bash npm install

安装教程

  1. 克隆仓库
  2. 安装依赖: bash npm install
  3. 创建并配置 .env 文件: bash cp .env.example .env nano .env
  4. 构建项目: bash npm run build

调试方式

  • 启动服务后,查看日志以调试问题:
  • STDIO 传输:直接查看控制台输出
  • SSE 传输:使用 docker-compose logs -f(如果使用 Docker)
  • 设置日志级别为 debug 以获取更详细的信息

许可证

该项目遵循 MIT 开源许可条款。