Perplexity MCP 서버

Perplexity의 API를 사용하여 쿼리 의도에 따라 자동으로 모델을 선택하고 웹 검색 기능을 제공하는 MCP 서버입니다.

필수 조건

• Node.js(v14 이상)
• Perplexity API 키( https://www.perplexity.ai/settings/api 에서 받으세요)
• 클로드 데스크톱 앱

설치

Git을 통해 설치

1. 이 저장소를 복제하세요:지엑스피1
2. 종속성 설치:
   npm install
3. 서버를 빌드하세요:
   npm run build

구성

1. https://www.perplexity.ai/settings/api 에서 Perplexity API 키를 받으세요.
2. ~/Library/Application Support/Claude/claude_desktop_config.json 에 있는 Claude의 구성 파일에 서버를 추가합니다.

/absolute/path/to 저장소를 복제한 실제 경로로 바꾸세요.

사용 가능한 모델

이제 서버는 쿼리 의도에 따른 자동 모델 선택을 지원하지만, PERPLEXITY_MODEL 환경 변수를 사용하여 기본 모델을 지정할 수도 있습니다. 사용 가능한 옵션은 다음과 같습니다.

• sonar-deep-research - 광범위한 연구 및 도메인 전반의 전문가 수준 분석을 위해 특화됨
• sonar-reasoning-pro - 고급 논리적 추론 및 복잡한 문제 해결에 최적화됨
• sonar-reasoning - 균형 잡힌 성능으로 추론 작업을 위해 설계되었습니다.
• sonar-pro - 뛰어난 검색 기능과 인용 밀도를 갖춘 범용 모델
• sonar - 간단한 쿼리에 빠르고 효율적

기본 모델(환경 변수에 지정됨)은 자동 모델 선택을 위한 기준으로 사용됩니다.

최신 모델 가격 및 가용성을 확인하려면 https://docs.perplexity.ai/guides/pricing을 방문하세요.

용법

서버를 구성하고 Claude를 다시 시작한 후에는 Claude에게 정보 검색을 요청하기만 하면 됩니다. 예:

• "SpaceX에 대한 최신 소식은 뭐예요?"
• "시카고 최고의 레스토랑을 찾아보세요"
• "재즈 음악의 역사에 대한 정보를 찾아보세요"
• "최근 AI 개발에 대한 심층적인 연구 분석이 필요합니다." (sonar-deep-research 사용)
• "이 복잡한 문제를 추론하는 데 도움을 주세요"(sonar-reasoning-pro 사용)

Claude는 Perplexity 검색 도구를 자동으로 사용하여 관련 정보를 찾아 반환합니다. 서버는 쿼리 의도에 따라 가장 적합한 모델을 자동으로 선택합니다.

어떤 이유로든 검색 도구를 사용하지 않기로 결정하면 프롬프트 앞에 "웹 검색"을 추가하여 강제로 문제를 해결할 수 있습니다.

지능형 모델 선택

서버는 귀하의 쿼리에 따라 가장 적합한 Perplexity 모델을 자동으로 선택합니다.

• "심층 연구", "포괄적" 또는 "심층적"과 같은 연구 지향적 용어를 사용하여 소나 심층 연구를 시작하세요.
• "해결하다", "알아내다" 또는 "복잡한 문제"와 같은 추론 용어를 사용하여 Sonar-Resoning-Pro를 트리거합니다.
• "빠른", "간단한" 또는 "기본"과 같은 간단한 용어를 사용하여 경량 소나 모델을 트리거합니다.
• 균형 잡힌 성능을 위해 일반 검색어는 기본적으로 sonar-pro로 설정됩니다.

각 검색 응답에는 어떤 모델이 사용되었는지, 그 이유가 무엇인지에 대한 정보가 포함되어 있습니다.

도메인 필터링

이 서버는 검색 환경을 맞춤 설정할 수 있는 도메인 필터링을 지원합니다. 다음 명령을 사용하여 특정 도메인을 허용하거나 차단할 수 있습니다.

• 허용된 도메인 추가 : "domain_filter 도구를 사용하여 wikipedia.org를 허용하세요"
• 차단된 도메인 추가 : "domain_filter 도구를 사용하여 pinterest.com 차단"
• 현재 필터 보기 : "list_filters 도구 사용"(도메인 및 최근 필터 표시)
• 모든 필터 지우기 : "clear_filters 도구 사용"(도메인 및 최근성 필터 모두 지움)

참고 : Perplexity API는 최대 3개의 도메인을 지원하며, 허용된 도메인에 우선순위가 부여됩니다. 도메인 필터링을 사용하려면 이 기능을 지원하는 Perplexity API 계층이 필요합니다.

사용 흐름 예시:

1. "domain_filter 도구를 사용하여 wikipedia.org를 허용하세요"
2. "arxiv.org를 허용하려면 domain_filter 도구를 사용하세요"
3. "list_filters 도구를 사용하세요"(설정을 확인하려면)
4. "양자 컴퓨팅 발전에 대한 검색"(검색 결과는 wikipedia.org와 arxiv.org를 우선시합니다)

최근성 필터링

최근성 필터를 사용하여 검색 결과를 특정 기간으로 제한할 수 있습니다.

• 최근성 필터 설정 : "filter=hour"와 함께 recency_filter 도구 사용(옵션: hour, day, week, month)
• 최근성 필터 비활성화 : "filter=none으로 recency_filter 도구 사용"

이 기능은 현재 이벤트나 속보와 같이 시간에 민감한 질의에 특히 유용합니다.

모델 선택 제어

대부분의 경우 자동 모델 선택이 잘 작동하지만, 어떤 모델을 사용할지 수동으로 제어할 수 있습니다.

• 모델 정보 보기 : "model_info 도구 사용"
• 특정 모델 설정 : "model=sonar-deep-research와 함께 model_info 도구를 사용하세요"
• 자동 선택으로 돌아가기 : 모델을 기본 모델로 되돌립니다.

사용 예:

1. "model_info 도구를 사용하세요"(사용 가능한 모델과 현재 상태를 보려면)
2. "model=sonar-reasoning-pro"와 함께 model_info 도구를 사용하세요(추론 모델 사용을 강제로 설정하려면)
3. "피타고라스 정리의 수학적 증명을 검색하세요"(sonar-reasoning-pro 사용)
4. "model=sonar-pro와 함께 model_info 도구를 사용하세요"(자동 선택으로 돌아가려면)

개발

서버를 수정하려면:

1. src/index.ts 편집하세요
2. npm run build 로 다시 빌드하세요
3. 변경 사항을 로드하려면 Claude를 다시 시작하세요.

특허

MIT