mcp-퍼플렉시티

Perplexity Chat MCP 서버

Perplexity MCP 서버는 Perplexity API에 Python 기반 인터페이스를 제공하여 응답 쿼리, 채팅 기록 관리 및 대화 관리를 위한 도구를 제공합니다. 환경 변수를 통한 모델 구성을 지원하고 채팅 데이터를 로컬에 저장합니다. Python과 setuptools로 구축되어 개발 환경과 통합되도록 설계되었습니다.

MCP 서버는 모델이 질문을 하고, 대화를 계속하고, 모든 채팅을 나열할 수 있도록 하여 사용자가 브라우저에서 Perplexity Chat과 상호 작용하는 방식을 모방하도록 설계되었습니다.

구성 요소

도구

ask_perplexity : Perplexity를 통해 전문가의 프로그래밍 지원을 요청하세요. 코딩 솔루션, 오류 디버깅 및 기술 설명에 중점을 둡니다. 출처 인용 및 대안 제안과 함께 답변을 제공합니다.
chat_perplexity : Perplexity AI와 진행 중인 대화를 유지합니다. 새 채팅을 만들거나 전체 기록 컨텍스트를 사용하여 기존 채팅을 이어갑니다. 향후 대화를 이어갈 수 있도록 채팅 ID를 반환합니다.
list_chats_perplexity : Perplexity AI에서 사용 가능한 모든 채팅 대화를 나열합니다. 채팅 ID, 제목, 생성 날짜를 반환합니다(상대 시간 형식, 예: "5분 전", "2일 전"). 결과는 페이지당 50개의 채팅으로 구성됩니다.
read_chat_perplexity : 특정 채팅의 전체 대화 기록을 가져옵니다. 모든 메시지와 타임스탬프를 포함한 전체 채팅 기록을 반환합니다. Perplexity에 대한 API 호출은 수행되지 않으며, 로컬 저장소에서만 데이터를 읽습니다.

주요 특징

환경 변수를 통한 모델 구성: PERPLEXITY_MODEL 환경 변수를 사용하여 Perplexity 모델을 지정하여 유연한 모델 선택을 할 수 있습니다.또한 PERPLEXITY_MODEL_ASK 및 PERPLEXITY_MODEL_CHAT 지정하여 ask_perplexity 및 chat_perplexity 도구에 대해 각각 다른 모델을 사용할 수 있습니다.이 모델들은 PERPLEXITY_MODEL 재정의합니다. Perplexity 설명서에서 사용 가능한 모델을 확인할 수 있습니다.
영구 채팅 기록: chat_perplexity 도구는 Perplexity AI와의 진행 중인 대화를 유지합니다. 전체 기록 컨텍스트를 사용하여 새 채팅을 생성하거나 기존 채팅을 이어갈 수 있습니다. 향후 계속 진행을 위해 채팅 ID를 반환합니다.
진행 상황 보고를 통한 스트리밍 응답: 진행 상황 보고를 사용하여 느린 응답으로 인한 시간 초과를 방지합니다.

빠른 시작

필수 조건

이 MCP 서버를 사용하기 전에 다음 사항이 있는지 확인하세요.

Python 3.10 이상
uvx 패키지 관리자가 설치되었습니다

참고: uvx 설치 지침은 여기에서 확인할 수 있습니다.

모든 클라이언트에 대한 구성

이 MCP 서버를 사용하려면 다음 설정으로 클라이언트를 구성하세요(구성 방법은 클라이언트마다 다릅니다).

지엑스피1

환경 변수

다음 환경 변수를 사용하여 MCP Perplexity 서버를 구성하세요.

변하기 쉬운	설명	기본값	필수의
`PERPLEXITY_API_KEY`	Perplexity API 키	없음	예
`PERPLEXITY_MODEL`	상호작용을 위한 기본 모델	`sonar-pro`	아니요
`PERPLEXITY_MODEL_ASK`	`ask_perplexity` 도구에 대한 특정 모델	`PERPLEXITY_MODEL` 사용합니다	아니요
`PERPLEXITY_MODEL_CHAT`	`chat_perplexity` 도구에 대한 특정 모델	`PERPLEXITY_MODEL` 사용합니다	아니요
`DB_PATH`	채팅 기록 데이터베이스를 저장하는 경로	`chats.db`	아니요
`WEB_UI_ENABLED`	웹 UI 활성화 또는 비활성화	`false`	아니요
`WEB_UI_PORT`	웹 UI용 포트	`8050`	아니요
`WEB_UI_HOST`	웹 UI를 위한 호스트	`127.0.0.1`	아니요
`DEBUG_LOGS`	자세한 로깅 활성화	`false`	아니요

Smithery CLI 사용

npx -y @smithery/cli@latest run @daniel-lxs/mcp-perplexity --config "{\"perplexityApiKey\":\"pplx-abc\",\"perplexityModel\":\"sonar-pro\"}"

용법

ask_perplexity

ask_perplexity 도구는 특정 질문에 사용되는 도구로, 채팅 기록을 유지하지 않으며 모든 요청은 새로운 채팅입니다.

도구는 지정된 경우 PERPLEXITY_MODEL_ASK 모델을 사용하여 Perplexity AI에서 응답을 반환하고, 그렇지 않은 경우 PERPLEXITY_MODEL 모델을 사용합니다.

채팅_퍼플렉시티

chat_perplexity 도구는 진행 중인 대화에 사용되며, 채팅 기록을 유지합니다. 채팅은 채팅 ID로 식별되며, 새 채팅이 생성될 때 도구에서 이 ID를 반환합니다. 채팅 ID는 다음과 같습니다: wild-horse-12 .

이 도구는 디버깅, 조사 및 채팅 기록이 필요한 다른 작업에 유용합니다.

이 도구는 지정된 경우 PERPLEXITY_MODEL_CHAT 모델을 사용하여 Perplexity AI에서 응답을 반환하고, 그렇지 않은 경우 PERPLEXITY_MODEL 모델을 사용합니다.

리스트_챗_퍼플렉시티

사용 가능한 모든 채팅 대화를 나열합니다. 채팅 ID, 제목, 생성 시간(상대적 형식)을 페이지별로 표시한 채팅 목록을 반환합니다. page 인수를 사용하여 페이지 번호를 지정할 수 있습니다(기본값은 1이며, 페이지당 채팅 수는 50개입니다).

읽기_채팅_복잡성

주어진 chat_id 에 대한 전체 대화 기록을 검색합니다. 이 도구는 타임스탬프와 역할(사용자 또는 비서)을 포함하여 채팅의 모든 메시지를 반환합니다. 이 도구는 Perplexity에 API 호출을 하지 않으며 , 로컬 데이터베이스에서만 데이터를 읽습니다.

웹 UI

이제 MCP Perplexity 서버에 웹 인터페이스가 포함되어 채팅 상호작용과 관리가 더욱 쉬워졌습니다.

특징

대화형 채팅 인터페이스
채팅 기록 관리
실시간 메시지 표시

스크린샷

채팅 목록 보기

채팅 인터페이스

웹 UI에 접근하기

WEB_UI_ENABLED true 로 설정하면 웹 UI를 http://WEB_UI_HOST:WEB_UI_PORT 에서 사용할 수 있습니다.

기본적으로 http://127.0.0.1:8050 입니다.

개발

이 프로젝트는 개발 및 빌드에 setuptools를 사용합니다. 시작하려면 다음을 수행하세요.

가상 환경 만들기:
python -m venv .venv source .venv/bin/activate # On Linux/macOS # or .venv\Scripts\activate # On Windows
모든 종속성을 포함하여 편집 가능한 모드로 프로젝트를 설치합니다.
pip install -e .
프로젝트를 빌드하세요:
python -m build

가상 환경에는 개발에 필요한 모든 종속성이 포함됩니다.

기여하다

이 프로젝트는 여러분의 참여를 환영합니다. 자세한 내용은 CONTRIBUTING.md 파일을 참조하세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여됩니다. 자세한 내용은 라이선스 파일을 참조하세요.

mcp-perplexity

Integrations