AI问答服务器

一个轻量级的MCP服务器,集成Perplexity AI到开发环境中,提供实时问答和AI驱动的答案,支持实时网络搜索和引用。

  • by shahar42
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 shahar42/Perplexity_custom_mcp_server

使用说明

困惑MCP服务器

一个轻量级的MCP(模型上下文协议)服务器,将Perplexity AI与您的开发环境集成在一起。通过实时网络搜索和引用,提出实时问题并获得人工智能支持的答案。

特性

  • 🌐 实时网络搜索 -获取引用的最新信息
  • 🤖 多种型号 -从5种不同的困惑模型中选择
  • 💬 易于集成 -与Claude Code和其他MCP客户合作
  • ⚡ 快速轻便 -最小的依赖关系,快速设置
  • 🔒 安全 -您的API密钥保持在本地

可用型号

型号 用例
声呐 轻量级实时搜索(默认)
声纳专业 增强搜索,提供更丰富的上下文
声纳推理 实时推理,逐步分析
声纳推理专业 使用DeepSeek-R1进行高级推理
声纳深度研究 长篇研究与综合

快速启动(单线安装)

先决条件

  • Linux或macOS
  • Python 3.8+
  • curl (通常预装)

安装

  1. 克隆存储库
git clone https://github.com/yourusername/perplexity-mcp-server.git
cd perplexity-mcp-server
  1. 运行安装脚本
chmod +x install.sh
./install.sh
  1. 提示时输入您的困惑API键
    • 在获取免费API密钥https://www.perplexity.ai/

就是这样! ✅

手动设置(如果需要)

如果脚本不适合您:

# Create virtual environment
python3 -m venv venv
source venv/bin/activate

# Install dependencies
pip install -r requirements.txt

# Setup environment
cp .env.example .env
# Edit .env and add your API key
nano .env

用法

启动服务器

source venv/bin/activate
python server.py

使用克劳德代码

添加到您的Claude设置(通常 ~/.claude/settings.json):

{
  "mcpServers": {
    "perplexity": {
      "command": "path/to/perplexity-mcp-server/venv/bin/python",
      "args": ["path/to/perplexity-mcp-server/server.py"],
      "env": {
        "PERPLEXITY_API_KEY": "your-api-key-here"
      }
    }
  }
}

然后重新启动Claude,您将可以访问:

  • perplexity_ask -使用可配置的模型和参数提问
  • list_models -查看所有可用型号

查询示例

看 示例.md 详细示例包括:

  • 基本查询和信息请求
  • 高级推理和逐步分析
  • 长篇研究与综合
  • 自定义参数使用
  • 真实世界的工作流程

快速示例:

基本问题

Ask Perplexity: "What are the latest developments in AI (2025)?"

高级推理

Ask with sonar-reasoning model: "Explain how transformers work in machine learning"

研究

Ask with sonar-deep-research model: "Write a comprehensive summary of renewable energy trends"

API密钥设置

  1. 首选https://www.perplexity.ai/
  2. 注册或登录
  3. 从API设置获取API密钥
  4. 跑 ./install.sh 或将其添加到 .env:
    PERPLEXITY_API_KEY=your_key_here
    

故障排除

“需要PERPLEXITY_API_KEY环境变量”

  • 确保 .env 文件存在并且包含您的API密钥
  • 运行: cat .env | grep PERPLEXITY_API_KEY

“卷曲失败”或“HTTP 401”

  • 您的API密钥无效或已过期
  • 从获取新的https://www.perplexity.ai/

Python版本问题

  • 确保你使用的是Python 3.8+
  • 请检查: python3 --version

venv激活问题

在某些Linux系统上:

source venv/bin/activate
# or
. venv/bin/activate

运作原理

服务器使用:

  • FastMCP -用于MCP协议的实现
  • 卷曲 -用于对困惑API的直接HTTP请求
  • python dotenv -用于安全的环境变量管理

没有严重的依赖关系-这正是您所需要的!

贡献

发现bug了吗?有什么建议吗?请在GitHub上打开一个问题!

许可证

MIT许可证-随意使用和修改

问题?

检查 困惑API文档 有关模型和参数的更多详细信息。


专为开发者打造。开发者。