Perplexity Insight MCP 서버

Perplexity AI API와 인터페이싱하기 위한 MCP 서버 구현으로, 표준화된 모델 컨텍스트 프로토콜을 통해 고급 질의응답 기능을 제공합니다.

특징

Perplexity AI API와의 원활한 통합
다양한 Perplexity 모델 지원(Sonar-reasoning, Sonar-pro, Sonar-deep-research)
사용자 정의 가능한 시스템 프롬프트 및 사용자 쿼리
적절한 오류 처리 및 응답 형식
속도 제한 보호
Windsurf IDE와의 간편한 통합

요구 사항

노드.js 18+
Perplexity API 키

설치

지엑스피1

환경 변수

다음 변수를 사용하여 .env 파일을 만듭니다.

PERPLEXITY_API_KEY=your_api_key_here

용법

서버를 실행합니다:

npm start

API 도구

서버는 다음 도구를 제공합니다.

perplexity_ask - Perplexity AI에 직접 질문 보내기
perplexity_search - Perplexity AI로 검색 쿼리 수행

모델 변경

두 도구 모두 다음과 같은 Perplexity 모델을 지원합니다.

sonar-reasoning (기본값) - Perplexity의 추론 중심 모델로 일반적인 질문에 가장 적합합니다.
sonar-pro - 전문적인 사용 사례를 위한 향상된 기능을 갖춘 향상된 모델
sonar-deep-research - 심층 연구 및 복잡한 질의에 특화됨

도구를 사용할 때 모델을 지정하려면 요청에 model 매개변수를 포함하세요.

Ask Perplexity using sonar-deep-research: What are the latest advancements in quantum computing?

시스템 프롬프트와 최대 토큰 수를 사용자 지정할 수도 있습니다.

Search with Perplexity using sonar-pro with system prompt "You are a helpful research assistant" and max tokens 2000: Latest developments in renewable energy

도구 응답 형식

서버는 도구 응답에 대한 MCP 사양을 따릅니다.

{
  content: [
    {
      type: "text",
      text: "Response content from Perplexity AI"
    }
  ],
  isError: false // or true if an error occurred
}

윈드서프 통합

윈드서프에서의 세팅

서버를 빌드하세요:
npm run build
Windsurf를 열고 설정으로 이동하세요.
"AI 설정" 또는 "모델 컨텍스트 프로토콜" 섹션을 찾으세요.
다음 세부정보로 새로운 MCP 서버를 추가합니다.
- 이름 : Perplexity Insight
- 유형 : 로컬 프로세스
- 명령어 : Node.js 실행 파일의 경로
- 인수 : 컴파일된 index.js 파일의 경로
- 작업 디렉토리 : 프로젝트 디렉토리 경로
- 환경 변수 : PERPLEXITY_API_KEY=your_api_key_here 포함해야 합니다.
필요한 경우 서버를 활성화하고 Windsurf를 다시 시작하세요.

구성 예

mcp_config.json 파일에 대한 구성 예는 다음과 같습니다.

"perplexity-ask": {
  "command": "node",
  "args": [
    "/path/to/perplexity-insight-MCP/dist/index.js"
  ],
  "cwd": "/path/to/perplexity-insight-MCP",
  "env": {
    "PERPLEXITY_API_KEY": "pplx-xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
  }
}

/path/to/perplexity-insight-MCP 설치 디렉터리의 실제 경로로 바꾸고 실제 Perplexity API 키를 사용하세요.

윈드서핑에서 Perplexity 사용하기

AI Assistant 패널을 사용하여 Perplexity로 전달될 질문을 하세요.
웹 검색의 경우 쿼리에 "검색 대상"과 같은 특정 용어를 포함하세요.
모델을 변경하려면 "모델 변경" 섹션에 표시된 대로 쿼리에 모델 이름을 포함하세요.
Windsurf는 귀하의 질의에 따라 자동으로 적절한 Perplexity 도구를 사용합니다.

개발

지역 개발을 위해:

npm run dev

문제 해결

MCP 서버에 문제가 발생하는 경우:

API 키가 유효하고 .env 파일에 올바르게 설정되었는지 확인하세요.
응답 형식이 MCP 사양과 일치하는지 확인하세요.
서버 로그에서 오류 메시지를 찾아보세요.
Windsurf가 MCP 서버를 사용하도록 올바르게 구성되었는지 확인하세요.

특허

MIT