Perplexity API集成服务

为Claude Code提供可配置深度的高级搜索功能,支持低、中、高三种搜索深度,通过简单命令即可调用。

  • by Jobikinobi
  • 本地部署
  • 更新于
在 GitHub 查看 Jobikinobi/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密钥安全
  • []已创建实施计划
  • []已部署并测试的解决方案