Perplexity Ask

Perplexity Ask подключается к Perplexity API для живого поиска в интернете через Model Context Protocol. Интегрируйте с Claude, настраивайте параметры и легко разворачивайте с Docker. Улучшите рабочие процессы в Data Science.

Data Science и ML Разработка API Прочее Официальные ★ 1.5k GitHub (1,500 ★)

Этот инструмент интегрирует Perplexity Sonar API с Model Context Protocol, что позволяет Claude выполнять поиск в реальном времени по всему интернету непосредственно в среде MCP. Благодаря взаимодействию с Sonar API пользователи могут использовать живые веб-поиски для улучшения своих взаимодействий с Claude, повторяя функциональность веб-приложения Perplexity. Процесс настройки включает получение ключа API Sonar, настройку Claude desktop и создание образа Docker для удобной интеграции.

Ключевые возможности

01Ведение диалогов с Sonar API для выполнения живых веб-поисков.

02Позволяет пользователям отправлять сообщения с определёнными ролями и содержимым.

03Интеграция с Claude desktop для быстрого доступа к возможностям веб-поиска.

04Предоставляет образ Docker для упрощённого развёртывания и настройки.

05Позволяет изменять параметры поиска для настройки вызовов API.

Примеры использования

01Дополнение ответов Claude актуальной информацией из интернета.

02Выполнение веб-исследований непосредственно в среде Model Context Protocol.

03Интеграция возможностей веб-поиска в существующие рабочие процессы MCP.

Perplexity Ask MCP Server

An MCP server implementation that integrates the Sonar API to provide Claude with unparalleled real-time, web-wide research.

Tools

perplexity_ask
- Engage in a conversation with the Sonar API for live web searches.
- Inputs:
  - messages (array): An array of conversation messages.
    - Each message must include:
      - role (string): The role of the message (e.g., system, user, assistant).
      - content (string): The content of the message.

Configuration

Step 1:

Clone this repository:

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

Navigate to the perplexity-ask directory and install the necessary dependencies:

cd modelcontextprotocol/perplexity-ask && npm install

Step 2: Get a Sonar API Key

Sign up for a Sonar API account.
Follow the account setup instructions and generate your API key from the developer dashboard.
Set the API key in your environment as PERPLEXITY_API_KEY.

Step 3: Configure Claude Desktop

Download Claude desktop here.
Add this to your claude_desktop_config.json:

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

NPX

{
  "mcpServers": {
    "perplexity-ask": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/server-perplexity-ask"
      ],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

You can access the file using:

vim ~/Library/Application\ Support/Claude/claude_desktop_config.json

Step 4: Build the Docker Image

Docker build:

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

Step 5: Testing

Let's make sure Claude for Desktop is picking up the two tools we've exposed in our perplexity-ask server. You can do this by looking for the hammer icon:

After clicking on the hammer icon, you should see the tools that come with the Filesystem MCP Server:

If you see both of these this means that the integration is active. Congratulations! This means Claude can now ask Perplexity. You can then simply use it as you would use the Perplexity web app.

Step 6: Advanced parameters

Currently, the search parameters used are the default ones. You can modify any search parameter in the API call directly in the index.ts script. For this, please refer to the official API documentation.

Troubleshooting

The Claude documentation provides an excellent troubleshooting guide you can refer to. However, you can still reach out to us at api@perplexity.ai for any additional support or file a bug.

License

This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.

Обзор

Perplexity Ask — это MCP-сервер, который подключает Claude (или любого MCP-клиента) к Sonar API от Perplexity. Он добавляет инструмент для выполнения живых поисковых запросов в реальном времени — можно задавать вопросы, на которые API ищет ответы по всему интернету.

Сервер предоставляет один инструмент:

perplexity_ask — принимает массив сообщений с ролями (system, user, assistant) и содержанием. Возвращает ответ Sonar API.

Установка

Шаг 1. Клонирование и зависимости

git clone git@github.com:ppl-ai/modelcontextprotocol.git
cd modelcontextprotocol/perplexity-ask
npm install

Шаг 2. Получение API-ключа

Зарегистрируйтесь на Sonar API.
В панели разработчика создайте API-ключ.
Установите переменную окружения:

export PERPLEXITY_API_KEY="ваш_ключ"

Шаг 3. Настройка Claude Desktop

Отредактируйте файл конфигурации claude_desktop_config.json (обычно находится по пути ~/Library/Application Support/Claude/claude_desktop_config.json). Добавьте один из вариантов:

Docker (рекомендуется):

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

NPX (альтернатива):

{
  "mcpServers": {
    "perplexity-ask": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-perplexity-ask"],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_API_KEY_HERE"
      }
    }
  }
}

Шаг 4. Сборка Docker-образа (если используете Docker)

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

Шаг 5. Проверка работы

После запуска Claude Desktop нажмите на иконку молотка (🔨) — должен появиться список инструментов MCP-сервера. Если вы видите perplexity_ask — интеграция активна. Теперь можно задавать вопросы Claude, и он будет использовать Sonar API для свежих поисковых результатов.

Расширенные параметры

По умолчанию используются стандартные настройки API. Если нужно изменить параметры поиска (например, количество результатов, модель, temperature), отредактируйте файл index.ts в репозитории и передайте нужные поля. Полный список параметров — в официальной документации Sonar API.

Устранение неполадок

Claude не видит сервер? Проверьте формат JSON, пути к файлам и наличие API-ключа.
Подробнее об отладке MCP — официальное руководство.
Если ничего не помогло, напишите на api@perplexity.ai или откройте issue.

Лицензия

MIT.

Источник: https://mcpmarket.com/server/perplexity-ask

Perplexity Ask

Ключевые возможности

Примеры использования

Perplexity Ask MCP Server

Tools

Configuration

Step 1:

Step 2: Get a Sonar API Key

Step 3: Configure Claude Desktop

NPX

Step 4: Build the Docker Image

Step 5: Testing

Step 6: Advanced parameters

Troubleshooting

License

Обзор

Установка

Шаг 1. Клонирование и зависимости

Шаг 2. Получение API-ключа

Шаг 3. Настройка Claude Desktop

Шаг 4. Сборка Docker-образа (если используете Docker)

Шаг 5. Проверка работы

Расширенные параметры

Устранение неполадок

Лицензия

Что такое Perplexity Ask?

Каковы ключевые возможности Perplexity Ask?

Как интегрировать Perplexity Ask с Claude?

Можно ли настроить параметры поиска, используемые Perplexity Ask?

Бесплатно ли использовать Perplexity Ask?

Perplexity Ask

Parameters

Perplexity Research

Parameters

Perplexity Reason

Parameters

Perplexity Search

Parameters

Комментарии