Perplexity MCP Server

Perplexity API Platform MCP Server

     

Perplexity API Platform을 위한 공식 MCP 서버 구현체로, Sonar 모델과 Search API를 통해 AI 어시스턴트에 실시간 웹 검색, 추론 및 연구 기능을 제공합니다.

사용 가능한 도구

perplexity_search

Perplexity Search API를 사용한 직접 웹 검색. 메타데이터가 포함된 순위별 검색 결과를 반환하며, 최신 정보를 찾는 데 적합합니다.

perplexity_ask

sonar-pro 모델을 사용한 실시간 웹 검색 기반 범용 대화형 AI. 간단한 질문과 일상적인 검색에 적합합니다.

perplexity_research

sonar-deep-research 모델을 사용한 심층적이고 포괄적인 연구. 철저한 분석과 상세한 보고서에 이상적입니다.

perplexity_reason

sonar-reasoning-pro 모델을 사용한 고급 추론 및 문제 해결. 복잡한 분석 작업에 완벽합니다.

[!TIP] perplexity_reason 및 perplexity_research의 선택적 매개변수로 사용 가능: strip_thinking

응답에서 <think>...</think> 태그를 제거하여 컨텍스트 토큰을 절약하려면 true로 설정하세요. 기본값: false

구성

API 키 받기

1. API 포털에서 Perplexity API 키를 받으세요.
2. 아래 구성에서 your_key_here을 API 키로 교체하세요.
3. (선택 사항) 타임아웃 설정: PERPLEXITY_TIMEOUT_MS=600000 (기본값: 5분)
4. (선택 사항) 사용자 지정 기본 URL 설정: PERPLEXITY_BASE_URL=https://your-custom-url.com (기본값: https://api.perplexity.ai)
5. (선택 사항) 로그 레벨 설정: PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR (기본값: ERROR)

Claude Code

claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

또는 플러그인을 통해 설치:

export PERPLEXITY_API_KEY="your_key_here"
claude
# Then run: /plugin marketplace add perplexityai/modelcontextprotocol
# Then run: /plugin install perplexity

Codex

codex mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

Cursor, Claude Desktop, Kiro, Windsurf 및 VS Code

대부분의 클라이언트는 클라이언트 구성에서 동일한 mcpServers 래퍼를 사용하여 수동으로 구성할 수 있습니다(Cursor에 표시된 대로). 클라이언트의 스키마가 다른 경우 정확한 래퍼 형식은 해당 문서를 확인하세요.

수동 설정의 경우, 이 클라이언트들은 모두 동일한 mcpServers 구조를 사용합니다:

클라이언트	구성 파일
Cursor	~/.cursor/mcp.json
Claude Desktop	claude_desktop_config.json
Kiro	.kiro/settings/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
VS Code	.vscode/mcp.json

{
  "mcpServers": {
    "perplexity": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "your_key_here"
      }
    }
  }
}

프록시 설정 (회사 네트워크용)

직장에서, 특히 회사 방화벽이나 프록시 뒤에서 이 서버를 실행하는 경우, 프로그램이 네트워크 프록시를 통해 인터넷 트래픽을 전송하는 방법을 알려줘야 할 수 있습니다. 다음 단계를 따르세요:

1. 프록시 세부 정보 얻기

• IT 부서에 HTTPS 프록시 주소와 포트를 문의하세요.
• 사용자 이름과 비밀번호가 필요할 수도 있습니다.

2. 프록시 환경 변수 설정

Perplexity MCP에서 가장 쉽고 안정적인 방법은 PERPLEXITY_PROXY을 사용하는 것입니다. 예를 들어:

export PERPLEXITY_PROXY=https://your-proxy-host:8080

프록시에 사용자 이름과 비밀번호가 필요한 경우 다음을 사용하세요:

export PERPLEXITY_PROXY=https://username:password@your-proxy-host:8080

3. 대안: 표준 환경 변수

표준 변수를 사용하려는 경우, HTTPS_PROXY 및 HTTP_PROXY을 지원합니다.

[!NOTE] 서버는 다음 순서로 프록시 설정을 확인합니다: PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY. 아무것도 설정되지 않은 경우 인터넷에 직접 연결됩니다. URL에는 https://이 포함되어야 합니다. 일반적인 포트는 8080, 3128, 80입니다.

HTTP 서버 배포

클라우드 또는 공유 배포의 경우 HTTP 모드로 서버를 실행하세요.

환경 변수

변수	설명	기본값
PERPLEXITY_API_KEY	Perplexity API 키	필수
PERPLEXITY_BASE_URL	API 요청을 위한 사용자 지정 기본 URL	https://api.perplexity.ai
PORT	HTTP 서버 포트	8080
BIND_ADDRESS	바인딩할 네트워크 인터페이스. 기본값은 루프백입니다. 모든 인터페이스에 노출하려면 0.0.0.0로 설정하세요.	127.0.0.1
ALLOWED_ORIGINS	CORS 출처 (쉼표로 구분). 기본값은 비어 있음 (교차 출처 브라우저 요청 없음). 명시적 허용 목록(예: https://app.example.com) 또는 모든 출처를 허용하려면 *로 설정하세요.	(비어 있음)
ALLOWED_HOSTS	허용할 추가 Host 헤더 값 (쉼표로 구분). PORT의 루프백 호스트는 항상 허용됩니다. 0.0.0.0에 바인딩할 때 공개 호스트 이름을 추가하세요.	(루프백만 해당)

Docker

docker build -t perplexity-mcp-server .
docker run -p 8080:8080 -e PERPLEXITY_API_KEY=your_key_here perplexity-mcp-server

Node.js

export PERPLEXITY_API_KEY=your_key_here
npm install && npm run build && npm run start:http

서버는 http://localhost:8080/mcp에서 액세스할 수 있습니다.

문제 해결

• API 키 문제: PERPLEXITY_API_KEY이 올바르게 설정되었는지 확인하세요.
• 연결 오류: 인터넷 연결 및 API 키 유효성을 확인하세요.
• 도구를 찾을 수 없음: 패키지가 설치되어 있고 명령 경로가 올바른지 확인하세요.
• 타임아웃 오류: 매우 긴 연구 쿼리의 경우 PERPLEXITY_TIMEOUT_MS을 더 높은 값으로 설정하세요.
• 프록시 문제: PERPLEXITY_PROXY 또는 HTTPS_PROXY 설정을 확인하고 api.perplexity.ai이 방화벽에 의해 차단되지 않았는지 확인하세요.
• EOF / 초기화 오류: 일부 엄격한 MCP 클라이언트는 npx이 stdout에 설치 메시지를 쓰기 때문에 실패합니다. 이 출력을 억제하려면 npx -y 대신 npx -yq을 사용하세요.

지원이 필요하면 community.perplexity.ai를 방문하거나 이슈를 제출하세요.

---