mcp-server-perplexity

🚀 Perplexity AI MCP 服务器

Perplexity AI MCP 服务器集成了 Perplexity AI API，为用户提供高级搜索功能以及多种模型选项，有效满足不同场景下的搜索需求。

🚀 快速开始

本服务器集成了 Perplexity AI API，为用户提供高级搜索功能和多种模型选项。

安装

pnpm install
pnpm build

配置 API 密钥

1. 在 Perplexity AI 账户 注册一个新账户。
2. 从仪表盘获取您的 API 访问密钥。
3. 设置环境变量：

export PERPLEXITY_API_KEY=your_api_key_here

运行服务

直接运行

node dist/index.js
# 或者如果已设置为可执行文件
./dist/index.js

开发模式

pnpm dev

通过 MCP Inspector 测试

pnpm inspect

✨ 主要特性

• 使用 Perplexity AI 模型进行搜索。
• 支持所有官方 Sonar 模型。
• 可配置的结果数量。
• 详细的错误处理和日志记录。
• 兼容 MCP Inspector。

📦 安装指南

pnpm install
pnpm build

💻 使用示例

基础用法

# 直接运行服务
node dist/index.js
# 或者如果已设置为可执行文件
./dist/index.js

高级用法

开发模式

# 开启开发模式运行服务
pnpm dev

通过 MCP Inspector 测试

# 使用 MCP Inspector 测试服务
pnpm inspect

📚 详细文档

工具参考 - perplexity_search

使用 Perplexity AI 的模型执行搜索操作。

| 参数 | 详情 | |------|------| | query | 字符串类型，必需参数，代表搜索查询内容。 | | model | 字符串类型，可选参数，使用的模型（默认为 "sonar"），可用选项包括 sonar-reasoning-pro、sonar-reasoning、sonar-pro、sonar。 | | count | 数字类型，可选参数，结果数量（范围为 1 - 10，默认值为 5）。 |

开发指南

项目结构

src/perplexity/
├── index.ts        # 主服务器实现文件
├── lib/
│   └── logger.ts   # 日志记录配置文件
└── adr.md         # 架构决策记录

日志记录

日志输出到项目根目录的 perplexity-mcp.log 文件中。

🔧 技术细节

本项目使用 Perplexity AI API 实现搜索功能，支持多种官方 Sonar 模型。通过配置环境变量来管理 API 密钥，确保了安全性和灵活性。在项目结构上，采用模块化设计，将主服务器实现、日志记录等功能分离，便于维护和扩展。日志记录功能详细记录了系统运行过程中的各种信息，有助于问题排查和系统监控。

📄 许可证

本项目采用 MIT 许可证。

🤝 如何贡献

1. 叉取仓库。
2. 创建功能特性分支。
3. 提交您的修改。
4. 推送到分支。
5. 提出新的拉取请求。