remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

Integrations

Provides integration with GitHub for source code hosting and version control.
Provides a tool for asking internet search queries through Perplexity AI, supporting both simple and complex queries with file attachment capabilities. Optimized for different query types to balance cost and performance.
Enables distribution of the package through the Python Package Index, allowing users to install the MCP via pip or uvx.

Perplexity 고급 MCP

한국어

개요

Perplexity Advanced MCP는 OpenRouter 및 Perplexity API를 활용하여 향상된 쿼리 처리 기능을 제공하는 고급 통합 패키지입니다. 직관적인 명령줄 인터페이스와 강력한 API 클라이언트를 갖춘 이 패키지는 간단한 쿼리부터 복잡한 쿼리까지 AI 모델과의 원활한 상호작용을 지원합니다.

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를 자동으로 설치하려면:

npx -y @smithery/cli install @code-yeongyu/perplexity-advanced-mcp --client claude

uvx 로 빠르게 시작하기

MCP 서버를 실행하는 가장 쉬운 방법은 uvx를 사용하는 것입니다.

uvx perplexity-advanced-mcp -o <openrouter_api_key> # or -p <perplexity_api_key>

환경 변수를 사용하여 API 키를 구성할 수도 있습니다.

export OPENROUTER_API_KEY="your_key_here"
# or
export PERPLEXITY_API_KEY="your_key_here"

uvx perplexity-advanced-mcp

메모:

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 )은 쿼리 유형을 특정 모델에 매핑합니다.
- 오픈라우터 :
  - 간단한 쿼리: perplexity/sonar
  - 복잡한 쿼리: perplexity/sonar-reasoning
- 당혹감 :
  - 간단한 쿼리: sonar-pro
  - 복잡한 쿼리: sonar-reasoning-pro

개발 배경 및 철학

이 프로젝트는 제 개인적인 호기심과 실험 정신에서 시작되었습니다. 최근 "바이브 코딩" 트렌드를 따라, 코드의 95% 이상을 Cline + Cursor IDE를 통해 작성했습니다. "말은 싸니까, 코드를 보여줘"라는 말이 있죠. Wispr Flow 의 음성-텍스트 변환 마법 덕분에, 제가 말만 하면 코드가 바로 나타났습니다! 개발의 대부분은 "xyz 코드를 작성해 줘, 여기 xy z 버그를 수정해 줘."와 같은 말과 엔터 키를 누르는 것으로 진행되었습니다. 놀랍게도, 이 모든 기능을 갖춘 프로젝트를 만드는 데 몇 시간도 걸리지 않았습니다.

프로젝트 스캐폴딩부터 파일 구조까지 모든 것이 LLM을 통해 작성되고 검토되었습니다. PyPI 게시를 위한 GitHub Actions 워크플로와 릴리스 승인 프로세스도 Cursor를 통해 처리되었습니다. 실제 개발자로서 제 역할은 다음과 같았습니다.

AI가 적절한 테스트를 수행할 수 있도록 MCP 서버 시작 및 중지
문제 발생 시 오류 로그 복사 및 제공
인터넷에서 Python MCP SDK 문서 및 예제 찾기 및 제공
올바르지 않은 것으로 보이는 코드에 대한 수정 요청

오늘날 많은 것이 자동화되고 대체될 수 있는 세상에서, 이 MCP가 여러분처럼 MCP를 사용하는 개발자들이 단순한 코드 작성을 넘어 가치를 발견하는 데 도움이 되기를 바랍니다. 이 도구가 여러분이 더 높은 수준의 의사 결정과 고려 사항을 수행할 수 있는 새로운 시대의 개발자로 거듭나는 데 도움이 되기를 바랍니다.

개발

이 패키지에 기여하거나 수정하려면:

1. 저장소 복제:

gh repo clone code-yeongyu/perplexity-advanced-mcp

2. 종속성 설치:

uv sync

3. 기여:

기여를 환영합니다! 기존 코드 스타일과 커밋 지침을 따라주세요.

특허

이 프로젝트는 MIT 라이선스에 따라 라이선스가 부여되었습니다.

This server cannot be installed

-

security - not tested

F

license - not found

-

quality - not tested

OpenRouter와 Perplexity API를 활용하여 향상된 웹 검색 기능을 제공하는 고급 통합 패키지로, 파일 첨부 지원을 통해 간단한 쿼리 처리와 복잡한 쿼리 처리를 모두 제공합니다.