开源项目安装与配置指南

开源项目安装与配置指南

modelcontextprotocol A Model Context Protocol Server connector for Perplexity API, to enable web search without leaving the MCP ecosystem. 项目地址: https://gitcode.com/gh_mirrors/mo/modelcontextprotocol

1. 项目基础介绍

本项目是一个开源的Model Context Protocol（MCP）服务器连接器，用于Perplexity API。它允许用户在不离开MCP生态系统的情况下进行实时的网络搜索。该项目的目标是提供与Sonar API的无缝集成，以支持Claude进行强大的实时网络搜索。

主要编程语言：JavaScript

2. 关键技术和框架

• Model Context Protocol（MCP）：用于构建可插拔、可扩展的会话AI系统的协议。
• Sonar API：用于实时网络搜索的API。
• Claude Desktop：一个AI桌面应用程序，用于集成不同的MCP服务器。
• Docker：用于容器化应用程序，简化部署和运行过程。
• Node.js：JavaScript运行环境，用于执行后端服务。

3. 安装和配置准备工作

在开始安装之前，请确保您的系统中已安装以下工具：

• Git：用于克隆和操作项目代码。
• Docker：用于运行Docker容器。
• Node.js和npm：用于安装项目依赖。

安装步骤

步骤1：克隆项目仓库

打开终端（或命令提示符），执行以下命令克隆项目：

git clone git@github.com:ppl-ai/modelcontextprotocol.git

步骤2：安装项目依赖

进入项目目录：

cd modelcontextprotocol/perplexity-ask

然后安装项目依赖：

npm install

步骤3：获取Sonar API密钥

访问Sonar API网站，注册账户并生成API密钥。将生成的API密钥设置为环境变量PERPLEXITY_API_KEY。

步骤4：配置Claude Desktop

下载并安装Claude Desktop应用程序。然后编辑claude_desktop_config.json文件，添加MCP服务器配置。

{
  "mcpServers": {
    "perplexity-ask": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "-e", "PERPLEXITY_API_KEY", "mcp/perplexity-ask"],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

确保将YOUR_API_KEY_HERE替换为你的实际API密钥。

步骤5：构建Docker镜像（可选）

如果你需要自定义或优化Docker镜像，可以执行以下命令构建：

docker build -t mcp/perplexity-ask:latest -f Dockerfile

步骤6：测试配置

打开Claude Desktop，检查是否能够识别并使用Perplexity Ask工具。

以上步骤完成后，您应该能够成功安装和配置项目，开始使用Perplexity API进行实时网络搜索。

modelcontextprotocol A Model Context Protocol Server connector for Perplexity API, to enable web search without leaving the MCP ecosystem. 项目地址: https://gitcode.com/gh_mirrors/mo/modelcontextprotocol