Perplexity 고급 MCP
개요
Perplexity Advanced MCP는 OpenRouter 및 Perplexity API를 활용하여 향상된 쿼리 처리 기능을 제공하는 고급 통합 패키지입니다. 직관적인 명령줄 인터페이스와 강력한 API 클라이언트를 갖춘 이 패키지는 간단한 쿼리부터 복잡한 쿼리까지 AI 모델과의 원활한 상호작용을 지원합니다.
Related MCP server: Perplexity MCP Server
perplexity-mcp 와의 비교
perplexity-mcp는 Perplexity AI의 API를 사용하여 기본적인 웹 검색 기능을 제공하는 반면, Perplexity Advanced MCP는 여러 가지 추가 기능을 제공합니다.
다중 공급업체 지원: Perplexity 와 OpenRouter API를 모두 지원하므로 공급업체를 선택할 때 유연성이 제공됩니다.
쿼리 유형 최적화: 간단한 쿼리와 복잡한 쿼리를 구분하여 비용과 성능을 최적화합니다.
파일 첨부 지원: 쿼리에 파일 내용을 컨텍스트로 포함시켜 보다 정확하고 상황에 맞는 응답을 제공할 수 있습니다.
향상된 재시도 논리: 향상된 안정성을 위해 강력한 재시도 메커니즘을 구현합니다.
전반적으로 이것은 Cline 이나 Cursor와 같은 편집기와 통합할 때 코드베이스를 처리하는 데 가장 적합한 MCP입니다.
특징
통합 API 클라이언트: 간단한 쿼리와 복잡한 쿼리를 처리하기 위한 구성 가능한 모델을 통해 OpenRouter 와 Perplexity API를 모두 지원합니다.
명령줄 인터페이스(CLI): Typer를 사용하여 API 키 구성을 관리하고 MCP 서버를 실행합니다.
고급 쿼리 처리: 파일 첨부 처리를 통합하여 쿼리에 문맥적 데이터를 포함할 수 있습니다.
강력한 재시도 메커니즘: 일관되고 안정적인 API 통신을 보장하기 위해 재시도 논리에 Tenacity를 활용합니다.
사용자 정의 로깅: 세부적인 디버깅 및 런타임 모니터링을 위한 유연한 로깅 구성.
최적의 AI 구성
AI 어시스턴트(예: Cursor , Claude for Desktop )를 가장 잘 활용하려면 프로젝트 지침이나 AI 규칙에 다음 구성을 추가하는 것이 좋습니다.
지엑스피1
이러한 구성은 AI 도우미가 Perplexity 검색 기능을 언제 어떻게 사용해야 하는지 더 잘 이해하고 비용과 성능을 모두 최적화하는 데 도움이 됩니다.
용법
Smithery를 통해 설치
Smithery를 통해 Claude Desktop용 Perplexity Advanced MCP를 자동으로 설치하려면:
uvx 로 빠르게 시작하기
MCP 서버를 실행하는 가장 쉬운 방법은 uvx를 사용하는 것입니다.
환경 변수를 사용하여 API 키를 구성할 수도 있습니다.
메모:
OpenRouter와 Perplexity API 키를 동시에 제공하면 오류가 발생합니다.
CLI 인수와 환경 변수가 모두 제공되는 경우 CLI 인수가 우선합니다.
CLI는 Typer 로 구축되어 사용자 친화적인 명령줄 환경을 보장합니다.
MCP 검색 도구
이 패키지에는 ask_perplexity 함수를 통해 통합된 MCP 검색 도구가 포함되어 있습니다. 간단한 쿼리와 복잡한 쿼리를 모두 지원하고, 파일 첨부를 처리하여 추가적인 맥락 정보를 제공합니다.
간단한 질의: 빠르고 효율적인 응답을 제공합니다.
복잡한 쿼리: 세부적인 추론을 수행하고 XML 형식으로 된 파일 첨부를 지원합니다.
구성
API 키: 명령줄 옵션이나 환경 변수를 통해
OPENROUTER_API_KEY또는PERPLEXITY_API_KEY구성합니다.모델 선택: 구성(
src/perplexity_advanced_mcp/config.py)은 쿼리 유형을 특정 모델에 매핑합니다.
개발 배경 및 철학
이 프로젝트는 제 개인적인 호기심과 실험 정신에서 시작되었습니다. 최근 "바이브 코딩" 트렌드를 따라, 코드의 95% 이상을 Cline + Cursor IDE를 통해 작성했습니다. "말은 싸니까, 코드를 보여줘"라는 말이 있죠. Wispr Flow 의 음성-텍스트 변환 마법 덕분에, 제가 말만 하면 코드가 바로 나타났습니다! 개발의 대부분은 "xyz 코드를 작성해 줘, 여기 xy z 버그를 수정해 줘."와 같은 말과 엔터 키를 누르는 것으로 진행되었습니다. 놀랍게도, 이 모든 기능을 갖춘 프로젝트를 만드는 데 몇 시간도 걸리지 않았습니다.
프로젝트 스캐폴딩부터 파일 구조까지 모든 것이 LLM을 통해 작성되고 검토되었습니다. PyPI 게시를 위한 GitHub Actions 워크플로와 릴리스 승인 프로세스도 Cursor를 통해 처리되었습니다. 실제 개발자로서 제 역할은 다음과 같았습니다.
AI가 적절한 테스트를 수행할 수 있도록 MCP 서버 시작 및 중지
문제 발생 시 오류 로그 복사 및 제공
인터넷에서 Python MCP SDK 문서 및 예제 찾기 및 제공
올바르지 않은 것으로 보이는 코드에 대한 수정 요청
오늘날 많은 것이 자동화되고 대체될 수 있는 세상에서, 이 MCP가 여러분처럼 MCP를 사용하는 개발자들이 단순한 코드 작성을 넘어 가치를 발견하는 데 도움이 되기를 바랍니다. 이 도구가 여러분이 더 높은 수준의 의사 결정과 고려 사항을 수행할 수 있는 새로운 시대의 개발자로 거듭나는 데 도움이 되기를 바랍니다.
개발
이 패키지에 기여하거나 수정하려면:
1. 저장소 복제:
2. 종속성 설치:
3. 기여:
기여를 환영합니다! 기존 코드 스타일과 커밋 지침을 따라주세요.
특허
이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.