Perplexity MCP Server

Perplexity MCP 服务

借助 Perplexity 的 Search API 为你的 AI Agent 强力赋能！

一个 MCP（Model Context Protocol）服务，提供对 Perplexity AI API 的全面访问。它使大模型和 AI Agent 能够执行快速、检索增强的查询，并开展详尽的多源深度研究，这一切都通过一个标准化、安全且易于集成的协议实现。

本服务基于 cyanheads/mcp-ts-template 构建，采用模块化架构，具备稳健的错误处理、日志记录和安全功能。

🚀 核心能力：Perplexity 工具 🛠️

本服务为你的 AI 配备专门工具，以充分利用 Perplexity 的独特能力：

工具名称	描述	主要特性
perplexity_search	使用 Perplexity API 执行快速的检索增强查询。适用于快速查询和实时信息检索。	- 按时间新近程度筛选（day、week、month、year）。 - 按域名或日期范围筛选。 - 使用 academic 模式优先考虑学术来源。 - 可选包含模型的内部推理过程（showThinking）。
perplexity_deep_research	针对复杂主题开展详尽的多源调查，并给出详细报告。	- 适用于深入研究和报告生成。 - 通过 reasoning_effort（low、medium、high）控制研究深度和成本。

注意：对于深度研究工具，我建议通过 MCP 客户端（如 Cline）允许更长的超时时间（例如 180 秒）。其他客户端可能会在 60 秒后超时，这不足以完成深度研究。

---

目录

概览	功能特性	安装
配置	项目结构
工具	开发	许可证

概述

Perplexity MCP 服务充当桥梁，让理解 Model Context Protocol (MCP) 的应用程序（MCP 客户端）——例如高级 AI 助手（大模型）、IDE 扩展或自定义研究工具——能够直接且高效地与 Perplexity AI API 交互。

你的工具无需进行复杂的一次性 API 集成，而是可以利用此服务来：

• 自动化研究：让 Agent 能够以编程方式执行快速查询或深入研究。
• 增强 AI 推理：为大模型提供来自 Web 的最新、可验证信息，以支撑其回复。
• 将搜索集成到工作流：无缝地将搜索增强生成添加到任何 AI 驱动的任务中。

此服务基于健壮的 mcp-ts-template 构建，提供了一种标准化、安全且高效的方式，通过 MCP 标准公开 Perplexity 的功能。

开发者说明：此仓库包含一个 .clinerules 文件，可作为你的大模型编码 Agent 的开发者速查表，快速参考代码库模式、文件位置和代码片段。

功能

核心工具

利用 mcp-ts-template 提供的健壮工具：

• 日志记录：结构化、可配置的日志记录，支持文件轮转和可选的 MCP 通知。
• 错误处理：集中式错误处理，使用标准化的 McpError 类型。
• 配置：通过 Zod 验证加载环境变量（dotenv）。
• 输入验证/清理：使用 zod 进行模式验证，并提供专用的清理工具。
• 请求上下文：通过 AsyncLocalStorage 使用唯一请求 ID 进行操作跟踪和关联。
• 类型安全：由 TypeScript 和 Zod 模式强制实施的强类型。
• HTTP 传输：使用 Hono 的高性能 HTTP 服务器，具有会话管理和 CORS 支持。
• 身份验证：健壮的身份验证层，支持 JWT 和 OAuth 2.1。

Perplexity 集成

• 双 API 支持：完全集成标准 Chat Completions API（perplexity_search）和更深入的研究模型（perplexity_deep_research）。
• 高级搜索控制：对搜索参数进行细粒度控制，包括时效性、域名过滤和学术来源优先级。
• 成本跟踪：根据 token 使用量和模型估算 API 调用成本的工具，帮助管理开支。
• 弹性 API 客户端：用于与 Perplexity API 交互的专用服务，具有内置错误处理和请求/响应日志记录。

安装

前置条件

• Node.js (>=18.0.0)
• npm（随 Node.js 一起提供）
• 一个 Perplexity API Key - 从你的 Perplexity 账户设置中获取

设置

1. 克隆仓库：

   git clone https://github.com/cyanheads/perplexity-mcp-server.git
   cd perplexity-mcp-server
   

2. 安装依赖：

   npm install
   

3. 构建项目：

   npm run build
   

配置

环境变量

在项目根目录创建 .env 文件来配置服务（你可以复制 .env.example）。这些变量也可以在 MCP 客户端的配置中设置。

变量	描述	默认值
PERPLEXITY_API_KEY	必填。 你的 Perplexity API 密钥。	""
MCP_TRANSPORT_TYPE	传输机制：stdio 或 http。	stdio
MCP_HTTP_PORT	HTTP 服务的端口（如果 MCP_TRANSPORT_TYPE=http）。	3010
MCP_HTTP_HOST	HTTP 服务的主机地址。	127.0.0.1
MCP_LOG_LEVEL	日志级别（debug、info、warn、error）。	info
MCP_AUTH_MODE	HTTP 的认证方式：jwt 或 oauth。	jwt
MCP_AUTH_SECRET_KEY	jwt 认证必填。 一个安全的密钥（至少 32 个字符）。	""

MCP 客户端设置

将以下内容添加到你的 MCP 客户端配置文件中（例如 cline_mcp_settings.json）：

{
  "mcpServers": {
    "perplexity-mcp-server": {
      "command": "node",
      "args": ["/path/to/your/perplexity-mcp-server/dist/index.js"],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY_HERE"
      }
    }
  }
}

项目结构

代码库在 src/ 目录下遵循模块化结构：

src/
├── index.ts              # Entry point: Initializes and starts the server
├── config/               # Configuration loading (env vars, package info)
│   └── index.ts
├── mcp-server/           # Core MCP server logic and capability registration
│   ├── server.ts         # Server setup, capability registration
│   ├── transports/       # Transport handling (stdio, http)
│   └── tools/            # MCP Tool implementations (subdirs per tool)
├── services/             # External service integrations (Perplexity API client)
├── types-global/         # Shared TypeScript type definitions
└── utils/                # Common utility functions (logger, error handler, etc.)

如需查看详细文件树，请运行 npm run tree 或参阅 docs/tree.md。

工具

Perplexity MCP 服务提供两个主要工具，用于与 Perplexity API 交互。

工具名称	描述	关键参数
perplexity_search	执行快速的、搜索增强的查询。	query、search_recency_filter?、search_domain_filter?、search_mode?、showThinking?
perplexity_deep_research	执行详尽的、多来源的研究查询。	query、reasoning_effort?

注意：所有工具都支持全面的错误处理，并返回结构化的 JSON 响应。

开发

构建与测试

# Build the project (compile TS to JS in dist/)
npm run build

# Clean build artifacts
npm run clean

# Generate a file tree representation for documentation
npm run tree

# Clean build artifacts and then rebuild the project
npm run rebuild

# Start the server using stdio (default)
npm start

许可证

本项目依据 Apache License 2.0 许可 - 详情请参阅 LICENSE 文件。

---