AI导哈

Perplexity API集成服务

一个提供与Perplexity API集成的MCP服务器，支持多种传输方式和详细的日志记录。

  • by MadeByNando
  • JavaScript
  • 本地部署
  • 更新于
在 GitHub 查看 madebynando/mcp-perplexity-server

使用说明

MCP困惑服务器

模型上下文协议（MCP）服务器，使用OpenAI SDK提供与困惑API的集成。

特性

  • 与Claude Desktop等MCP兼容客户端集成
  • 两个主要工具：
    • perplexity-query：向困惑API发送直接查询
    • perplexity-search：使用Perplexity的搜索功能进行网络搜索
  • 多种运输方式：
    • 本地客户端的STDIO传输
    • 通过HTTP为远程客户端提供SSE传输
  • 使用OpenAI SDK和用于困惑API的自定义基础URL
  • 调试的详细日志记录，包括级别：调试、信息、错误

安装

  1. 克隆此存储库

  2. 安装依赖项：

    npm install

  3. 创建一个 .env 使用您的困惑API密钥文件：

    cp .env.example .env

    然后编辑 .env 文件添加您的困惑API密钥，并根据需要自定义其他设置：

    nano .env

  4. 构建项目：

    npm run build

用法

使用STDIO传输（本地）

  1. 通过将以下内容添加到您的配置中，配置Claude Desktop以使用此MCP服务器 claude_desktop_config.json:

    {
  "mcp_servers": {
    "perplexity-api": {
      "transport": {
        "type": "stdio",
        "command": "node",
        "args": ["/absolute/path/to/mcp-perplexity-server/build/index.js"]
      }
    }
  }
}

  2. 重新启动克劳德桌面

  3. 现在，您可以通过键入以下命令来使用困惑工具 /tool

使用SSE传输（远程）

  1. 使用SSE传输启动服务器：

    npm run start:sse

    这将在中指定的端口上使用SSE传输启动服务器 .env 文件（默认值：3002）。

  2. 配置任何MCP兼容客户端以使用SSE端点连接到服务器：

    • SSE 端点 ： http://your-server-address:3002/sse
    • 消息端点： http://your-server-address:3002/messages

  3. 对于Claude Desktop，请将以下内容添加到您的 claude_desktop_config.json:

    {
  "mcp_servers": {
    "perplexity-api-remote": {
      "transport": {
        "type": "sse",
        "url": "http://localhost:3002/sse",
        "messagesUrl": "http://localhost:3002/messages"
      }
    }
  }
}

与光标一起使用

  1. 确保服务器如上所述使用SSE传输运行。

  2. 在光标中，导航到设置>功能>MCP。

  3. 使用以下示例在您的 mcp.json:

    {
  "mcpServers": {
    "perplexity-mcp-server": {
      "url": "http://localhost:3002/sse?api_key=your-secure-api-key-here"
    }
  }
}

    注：更换 your-secure-api-key-here 与价值 MCP_API_KEY 从你的 .env 文件。

  4. 保存配置，必要时刷新连接。

  5. 现在，您可以通过访问MCP功能在Cursor中使用困惑工具。

可用工具

困惑度查询

将直接查询发送到困惑API。

参数：

  • prompt （必填）：要发送给困惑的查询
  • model （可选）：要使用的模型，“声纳专业版”或“声纳推理专业版”（默认：“声纳专业级”）
  • systemPrompt （可选）：设置查询上下文的系统提示

困惑搜索

使用Perplexity的搜索功能执行网络搜索。

参数：

  • query （必填）：搜索查询
  • model （可选）：要使用的模型，“声纳专业版”或“声纳推理专业版”（默认：“声纳专业级”）

日志记录和调试

  • 服务器为调试目的提供详细的日志记录。
  • 日志级别包括调试、信息和错误，有助于跟踪服务器的操作和排除故障。

Docker部署

为了在VPS或任何具有Docker的服务器上轻松部署，您可以使用发布的Docker映像。

选项1：超简化部署（推荐）

  1. 将部署脚本下载到服务器：

    curl -L https://raw.githubusercontent.com/MadeByNando/mcp-perplexity-server/main/deploy.sh -o deploy.sh

  2. 使脚本可执行并启动：

    chmod +x deploy.sh
./deploy.sh

  3. 导航到创建的目录：

    cd mcp-perplexity-deployment

  4. 编辑文件 .env 要添加困惑API密钥：

    nano .env

    文件 .env.example 也可作为所有可能配置选项的参考。

  5. 启动服务器：

    docker-compose up -d

服务器将可在以下地址访问： http://votre-ip-serveur:3002/sse.

选项2：安装手册

  1. 创建文件 docker-compose.yml 在具有以下内容的服务器上：

    version: "3.8"

services:
  mcp-perplexity-server:
    image: madebynando/mcp-perplexity-server:latest
    container_name: mcp-perplexity-server
    restart: unless-stopped
    ports:
      - "3002:3002"
    environment:
      - PERPLEXITY_API_KEY=${PERPLEXITY_API_KEY}
      - PORT=3002
    volumes:
      - perplexity_logs:/app/logs
    networks:
      - mcp-network

networks:
  mcp-network:
    driver: bridge

volumes:
  perplexity_logs:

  2. 下载文件 .env.example 并将其用作创建文件的模板 .env:

    curl -L https://raw.githubusercontent.com/madebynando/mcp-perplexity-server/main/.env.example -o .env.example
cp .env.example .env

    然后编辑文件 .env 要添加困惑API密钥并根据需要自定义其他设置：

    nano .env

  3. 启动服务器：

    docker-compose up -d

Docker容器管理

  • 倒领事日志：

    docker-compose logs -f

  • 要停止服务器：

    docker-compose down

  • 要重新启动服务器：

    docker-compose restart

构建统一的图像多架构

如果您遇到架构兼容性问题（例如，在Mac M1/M2/M3和x86-64 VPS之间），可以构建和发布多架构Docker映像。此映像将与两种类型的处理器兼容。

Prérequis

  • 带BuildX的Docker桌面（在最新版本中默认安装）
  • Docker Hub帐户

构建多架构映像的步骤

  1. 下载构建脚本：

    curl -L https://raw.githubusercontent.com/MadeByNando/mcp-perplexity-server/main/build-multiarch.sh -o build-multiarch.sh

  2. 使脚本可执行并启动：

    chmod +x build-multiarch.sh
./build-multiarch.sh

Ce脚本va：

  1. 使用Docker BuildX创建和配置多体系结构生成器
  2. 为ARM64（Mac M1/M2/M3）和AMD64（标准VPS）体系结构构建Docker映像
  3. 将图像推送到标记下的Docker Hub madebynando/mcp-perplexity-server:latest

图像发布后，您可以在任何平台上的docker-compose.yml文件中使用它，无论是带有Apple硅芯片的Mac还是标准VPS服务器。

许可证

麻省理工学院

相关 MCP