MCP 服务器

Perplexity MCP Server

一个 Node.js 实现，它使 Claude 能够通过 Anthropic 的模型上下文协议与 Perplexity AI 的语言模型进行交互，从而提供高级聊天补全和快速查询的工具。

搜索

语言翻译

开发者工具

访问服务器

Tools

perplexity_ask

Send a simple query to Perplexity AI

perplexity_chat

Generate a chat completion using Perplexity AI

README

Perplexity MCP 服务器

概述

Perplexity MCP 服务器是 Anthropic 的模型上下文协议 (MCP) 的 Node.js 实现，它使 Claude 能够与 Perplexity 的语言模型进行交互。该服务器在 Claude 和 Perplexity AI 的功能之间提供了一个安全的桥梁，从而可以通过工具使用增强 AI 交互。

可用工具

该服务器目前实现了两个主要工具：

1. perplexity_chat

具有完整消息历史记录支持的高级聊天完成工具。

{
  "name": "perplexity_chat",
  "description": "使用 Perplexity AI 生成聊天完成",
  "parameters": {
    "model": "string (可选) - 以下之一：llama-3.1-sonar-small-128k-online, llama-3.1-sonar-large-128k-online, llama-3.1-sonar-huge-128k-online",
    "messages": "array of {role, content} objects - 对话历史记录",
    "temperature": "number (可选) - 0-2 之间的采样温度"
  }
}

2. perplexity_ask

用于快速提问的简化单查询界面。

{
  "name": "perplexity_ask",
  "description": "向 Perplexity AI 发送一个简单的查询",
  "parameters": {
    "query": "string - 要发送的问题或提示",
    "model": "string (可选) - 以下之一：llama-3.1-sonar-small-128k-online, llama-3.1-sonar-large-128k-online, llama-3.1-sonar-huge-128k-online"
  }
}

安装

克隆存储库：

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

安装依赖项：
```
npm install
```
创建 .env 文件：
```
PERPLEXITY_API_KEY=your-api-key-here
```
构建项目：
```
npm run build
```

Claude Desktop 配置

要将此服务器添加到 Claude Desktop，请更新您的 claude_desktop_config.json：

{
  "mcpServers": {
    //更多服务器...
    "perplexity": {
      "command": "node",
      "args": ["path\\to\\perplexity-mcp-server\\dist\\index.js"],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY"
      }
    }
    //更多服务器...
  }
}

配置文件通常位于：

Windows: %APPDATA%/Claude/config/claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/config/claude_desktop_config.json
Linux: ~/.config/Claude/config/claude_desktop_config.json

开发

启动具有自动重新编译的开发服务器：

npm run dev

该服务器使用 TypeScript 并使用 @modelcontextprotocol/sdk 包实现 MCP 协议。

架构

核心组件

PerplexityServer 类
- 实现 MCP 服务器协议
- 处理工具注册和执行
- 管理错误处理和服务器生命周期
工具系统
- 模块化工具定义
- 类型安全的工具处理程序
- 结构化输入验证

技术细节

使用 TypeScript 构建，以实现类型安全
使用 @modelcontextprotocol/sdk 实现 MCP
通过 stdio 传输进行通信
基于环境的配置

错误处理

该服务器实现了全面的错误处理：

API 错误报告
无效工具请求处理
连接错误管理
进程信号处理

依赖项

@modelcontextprotocol/sdk: ^1.0.3
dotenv: ^16.4.7
isomorphic-fetch: ^3.0.0

贡献

Fork 存储库
创建您的功能分支 (git checkout -b feature/amazing-feature)
提交您的更改 (git commit -m 'Add some amazing feature')
推送到分支 (git push origin feature/amazing-feature)
打开一个 Pull Request

安全

API 密钥通过环境变量管理
所有工具参数的输入验证
错误消息在输出之前经过清理
通过 MCP 协议进行进程隔离

许可证

本项目根据 ISC 许可证获得许可。

故障排除

常见问题和解决方案：

服务器未找到
- 验证 claude_desktop_config.json 中的路径是否正确
- 确保服务器已构建 (npm run build)
- 检查 Node.js 是否在您的 PATH 中
身份验证错误
- 验证 .env 中的 Perplexity API 密钥
- 检查 API 密钥是否具有所需的权限
工具执行错误
- 验证工具参数是否与架构匹配
- 检查网络连接
- 查看服务器日志以获取详细的错误消息