
MCP Perplexity Server

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 的场景
- 开发调试和日志记录需求
工具列表
- perplexity-query
- 功能:向 Perplexity API 发送直接查询
-
参数:
prompt
(必需):查询内容model
(可选):使用的模型(默认 "sonar-pro")systemPrompt
(可选):设置查询上下文的系统提示
-
perplexity-search
- 功能:使用 Perplexity 的搜索能力进行网络搜索
- 参数:
query
(必需):搜索查询model
(可选):使用的模型(默认 "sonar-pro")
常见问题解答
-
如何配置 Claude Desktop 使用此服务? 在
claude_desktop_config.json
中添加 MCP 服务器配置,指定传输类型和命令路径。 -
如何远程访问服务? 使用 SSE 传输方式,启动服务后通过
http://your-server-address:3002/sse
访问。 -
如何调试? 服务提供详细的日志记录,可通过设置日志级别(debug、info、error)进行调试。
使用教程
使用依赖
- 确保已安装 Node.js 和 npm
- 克隆仓库并安装依赖:
bash npm install
安装教程
- 克隆仓库
- 安装依赖:
bash npm install
- 创建并配置
.env
文件:bash cp .env.example .env nano .env
- 构建项目:
bash npm run build
调试方式
- 启动服务后,查看日志以调试问题:
- STDIO 传输:直接查看控制台输出
- SSE 传输:使用
docker-compose logs -f
(如果使用 Docker) - 设置日志级别为
debug
以获取更详细的信息