Mkusaka_mcp Server Perplexity

🚀 Perplexity AI MCP 服务器

这是一个集成了 Perplexity AI API 的 MCP 服务器实现，它提供了高级搜索功能，并且拥有多种模型选项，能为用户带来更丰富、精准的搜索体验。

🚀 快速开始

本服务器能让你借助 Perplexity AI 的强大能力进行搜索。在使用前，你需要完成安装和配置。

✨ 主要特性

• 强大搜索能力：使用 Perplexity AI 的模型进行搜索，为你提供高质量的搜索结果。
• 丰富模型支持：支持所有官方 Sonar 模型，满足不同场景的需求。
• 灵活结果配置：可配置搜索结果的数量，方便你按需获取信息。
• 完善错误处理：具备详细的错误处理和日志记录功能，让你及时了解系统运行情况。
• 高度兼容性：兼容 MCP Inspector，便于进行测试和调试。

📦 安装指南

在项目根目录下执行以下命令进行安装和构建：

pnpm install
pnpm build

📚 详细文档

配置

API 密钥

你需要从 Perplexity AI 获取 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_search

使用该工具可借助 Perplexity AI 的模型执行搜索，其参数说明如下：

开发

项目结构

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

日志记录

日志会写入项目根目录的 perplexity-mcp.log 文件中，方便你查看系统运行信息。

💻 使用示例

基础用法

# 直接执行服务器
node dist/index.js

高级用法

# 在开发模式下运行
pnpm dev

🔧 技术细节

本项目使用 Perplexity AI 的 API 实现搜索功能，支持多种 Sonar 模型。项目结构清晰，主服务器实现文件位于 src/perplexity/index.ts，日志记录配置在 src/perplexity/lib/logger.ts，同时还有架构决策文档 src/perplexity/adr.md。日志会详细记录系统运行情况，方便开发者进行调试和问题排查。

📄 许可证

本项目采用 MIT 许可证。

🤝 贡献指南

如果你想为该项目做出贡献，可以按照以下步骤进行：

1. 叉取仓库。
2. 创建你的功能分支。
3. 提交你的更改。
4. 推送到分支。
5. 创建新的 Pull Request。