Custom Perplexity MCP

困惑克劳德代码集成项目

项目概述

该项目旨在为Claude Code创建高度定制的困惑API集成，通过简单的命令实现高级搜索功能，可配置搜索深度（低、中、深），如 search-p for x,y,z on low.

研究结果：现有解决方案

可用MCP服务器（推荐路径）

经过研究， 多个优秀的MCP服务器已经存在 提供我们所寻求的功能：

1. jsonallen/困惑mcp （基于Python）

• 安装: uvx perplexity-mcp
• 特性：具有可选最近度过滤的Web搜索
• 整合：与Claude Code原生兼容
• 命令: claude mcp add-json "perplexity-mcp" '{"env":{"PERPLEXITY_API_KEY":"[your-api-key]","PERPLEXITY_MODEL":"sonar"},"command":"uvx","args":["perplexity-mcp"]}'

2. Alcova人工智能/困惑mcp （基于Go）

• 安装：Homebrew、Go或预构建的二进制文件
• 特性：增强搜索和推理能力
• 整合：适用于Claude Code、Claude Desktop和游标
• 命令: claude mcp add-json --scope user perplexity-mcp '{"type":"stdio","command":"perplexity-mcp","env":{"PERPLEXITY_API_KEY":"[your-api-key]"}}'

3. 官方困惑询问MCP服务器

• 安装：Docker或NPX
• 特性：实时网络范围内的研究
• 整合：原生MCP支持

提供困惑API型号

根据文件分析：

1. 声呐 -轻量级、经济高效的搜索模型
2. 声纳推理 -用于快速解决问题的快速推理模型
3. 声纳深度研究 -专家级研究，提供全面报告

项目需求分析

原始目标

• 为困惑API与克劳德代码集成定制设置
• 可配置的搜索参数（低、中、深）
• 简单的命令界面(search-p for x,y,z on low)
• 高质量的搜索结果

当前评估

现有的MCP服务器已经提供：

• ✅ 原生Claude代码集成
• ✅ 带身份验证的API访问令人困惑
• ✅ 多种模型选项（包括深入研究）
• ✅ 通过MCP工具实现简单的命令界面
• ✅ 无需自定义开发

成本控制和安全

付费服务-需要显式触发器

⚠️ 困惑是一项付费服务 -使用明确的触发器来避免不必要的成本：

• -P 标志： -P search for AI news
• perplexity 关键字： perplexity find tech updates
• search perplexity: search perplexity for research papers

在没有触发器的情况下，Claude默认使用免费搜索工具。

API密钥配置

• 看 .env.example 用于配置模板
• 使用环境变量进行配置
• 在Claude Code MCP设置中设置为 PERPLEXITY_API_KEY
• 永远不要将实际的API密钥提交到版本控制

推荐

使用现有的MCP服务器，而不是构建自定义解决方案 -它们提供了所有必需的功能，并具有专业维护、安全性和兼容性。

后续步骤

1. ✅ 已安装MCP服务器（jsonallen/confused-MCP）
2. ✅ 配置了安全措施的API密钥
3. ✅ 记录成本控制触发因素
4. 📖 看 COST_CONTROL_USAGE.md 详细使用指南
5. 🧪 基于测试触发器的使用来控制成本

项目文件状态

• \[x\] 需求分析已完成
• \[x\] 已研究的现有解决方案
• \[x\] API密钥安全
• \[\]已创建实施计划
• \[\]已部署并测试的解决方案