返回 MCP 目录
public公开dns本地运行

perplexity-mcp-server

一个基于Perplexity AI的简单MCP服务器,提供网页搜索功能,支持Windows环境下的开发和部署。

article

README

🚀 Perplexity MCP 服务器

这是一个简单的MCP服务器,允许您使用Perplexity AI搜索互联网,为您提供便捷的网络搜索服务。

🚀 快速开始

本服务器借助Perplexity AI实现网络搜索功能,您只需完成安装步骤,即可开启搜索之旅。

✨ 主要特性

  • 基于Perplexity AI,可进行高效的网络搜索。
  • 提供Windows系统下的详细安装和使用指南。
  • 具备完善的问题排查机制,帮助您解决常见问题。

📦 安装指南

先决条件

Windows上的步骤

  1. 克隆仓库:
git clone [repository-url]
cd perplexity-mcp-server
  1. 安装依赖项:
npm install
  1. 创建环境文件:
    • 在根目录下创建一个新文件.env
    • 添加您的Perplexity AI API密钥:
    PERPLEXITY_API_KEY=your_api_key_here
    

💻 使用示例

开发模式

npm run dev

生产模式

  1. 构建项目:
npm run build
  1. 启动服务器:
npm start

使用Windows批处理文件(推荐)

为了避免在Windows上环境变量的问题,使用提供的批处理文件:

  1. 首先构建项目:
npm run build
  1. 运行批处理文件:
.\run-perplexity-server.bat

或者双击run-perplexity-server.bat文件在Windows资源管理器中。

有关详细说明,请参阅Windows安装指南

📚 详细文档

Windows问题排查

常见问题

  1. 权限错误
    • 以管理员身份运行命令提示符或PowerShell
    • 检查项目目录中的文件权限
  2. 环境变量
    • 确保.env文件位于根目录中
    • .env文件中没有等于号=周围的空格
    • 修改环境变量后重新启动终端
    • 使用提供的批处理文件以避免环境变量问题
  3. Node.js问题
    • 验证Node.js安装:node --version
    • 确保npm已安装:npm --version

错误消息

如果看到Error: ENOENT: no such file or directory,请确保:

  • 所有路径使用正确的Windows样式分隔符
  • 您在正确的目录中
  • 必要文件存在

项目结构

perplexity-mcp-server/
├── src/
│   └── index.ts          # 主服务器实现
├── dist/                 # 编译输出
├── .env                  # 环境变量
├── package.json          # 项目配置
├── run-perplexity-server.bat # Windows批处理文件
└── tsconfig.json         # TypeScript配置

API 使用

服务器提供了一个工具perplexity_search用于网络搜索:

{
  "name": "perplexity_search",
  "arguments": {
    "query": "your search query here"
  }
}

📄 许可证

本项目采用MIT许可证。

help

运行方式说明

cloud

托管运行

托管运行通常表示这个 MCP Server 由服务方环境承载,用户一般按页面提供的连接方式或授权流程接入,不需要在本地长期启动一个 MCP 进程

  1. 打开服务方连接页
  2. 完成授权或复制端点
  3. 在 MCP 客户端中连接
terminal

本地运行 / 其它方式

本地运行通常需要用户在自己的电脑或服务器上安装依赖,把 server_config 复制到 MCP 客户端,并按 env_schema 补齐环境变量、密钥或其它配置

  1. 复制 server_config
  2. 安装所需依赖
  3. 补齐环境变量后重启客户端