mcp-perplexity-search

⚠️ 注意

此代码库已停止维护。

本工具的功能现已整合至 mcp-omnisearch，该聚合包集成了多个 MCP 工具。

请使用 mcp-omnisearch 替代本工具。

一个用于将 Perplexity AI API 与 LLM 集成的模型上下文协议（MCP）服务器。该服务器提供高级聊天补全功能，并包含针对不同使用场景的专用提示模板。

功能特性

• 🤖 使用 Perplexity AI 模型的高级聊天补全
• 📝 预定义常用场景提示模板：
  • 技术文档生成
  • 安全最佳实践分析
  • 代码审查与改进
  • 结构化格式的 API 文档
• 🎯 支持定制化专业用例模板
• 📊 多种输出格式（文本、Markdown、JSON）
• 🔍 可选的响应中包含来源 URL
• ⚙️ 可配置模型参数（temperature、max tokens）
• 🚀 支持多种 Perplexity 模型（包括 Sonar 和 LLaMA）

配置说明

需通过 MCP 客户端配置服务器，以下是不同环境配置示例：

Cline 配置

在 Cline MCP 设置中添加：

{
	"mcpServers": {
		"mcp-perplexity-search": {
			"command": "npx",
			"args": ["-y", "mcp-perplexity-search"],
			"env": {
				"PERPLEXITY_API_KEY": "your-perplexity-api-key"
			}
		}
	}
}

Claude Desktop 的 WSL 配置

WSL 环境配置示例：

{
	"mcpServers": {
		"mcp-perplexity-search": {
			"command": "wsl.exe",
			"args": [
				"bash",
				"-c",
				"source ~/.nvm/nvm.sh && PERPLEXITY_API_KEY=your-perplexity-api-key /home/username/.nvm/versions/node/v20.12.1/bin/npx mcp-perplexity-search"
			]
		}
	}
}

环境变量

必须配置的环境变量：

• PERPLEXITY_API_KEY: Perplexity API 密钥（必填）

API 接口

服务器实现了一个可配置参数的 MCP 工具：

chat_completion

使用 Perplexity API 生成聊天补全，支持专业提示模板。

参数说明：

• messages (数组，必填): 消息对象数组，包含：
  • role (字符串): 'system'、'user' 或 'assistant'
  • content (字符串): 消息内容
• prompt_template (字符串，可选): 预定义模板选项：
  • technical_docs: 含代码示例的技术文档
  • security_practices: 安全实施指南
  • code_review: 代码分析与改进
  • api_docs: JSON 格式的 API 文档
• custom_template (对象，可选): 自定义模板参数：
  • system (字符串): 定义助手行为的系统消息
  • format (字符串): 输出格式偏好
  • include_sources (布尔值): 是否包含来源
• format (字符串，可选): 输出格式 'text'、'markdown' 或 'json'（默认: 'text'）
• include_sources (布尔值，可选): 包含来源 URL（默认: false）
• model (字符串，可选): Perplexity 模型选择（默认: 'sonar'）
• temperature (数值，可选): 输出随机性（0-1，默认: 0.7）
• max_tokens (数值，可选): 最大响应长度（默认: 1024）

开发指南

环境搭建

1. 克隆代码库
2. 安装依赖：

pnpm install

3. 构建项目：

pnpm build

4. 开发模式运行：

pnpm dev

发布流程

使用 changesets 进行版本管理，发布步骤：

1. 创建变更记录：

pnpm changeset

2. 版本更新：

pnpm changeset version

3. 发布到 npm：

pnpm release

贡献指南

欢迎贡献代码！请随时提交 Pull Request。

许可协议

MIT 许可证 - 详见 LICENSE 文件。

致谢

• 基于 Model Context Protocol 构建
• 核心技术来自 Perplexity SONAR