local-only server

The server can only run on the client’s local machine because it depends on local resources.

Integrations

Enables interaction with Perplexity AI's language models, providing capabilities to generate chat completions with full message history support and send simple queries for quick answers using various Llama-based models.

Perplexity MCP 서버

개요

Perplexity MCP 서버는 Anthropic의 모델 컨텍스트 프로토콜(MCP)을 Node.js로 구현한 것으로, Claude가 Perplexity의 언어 모델과 상호 작용할 수 있도록 지원합니다. 이 서버는 Claude와 Perplexity AI의 기능 간 안전한 연결을 제공하여 도구 사용을 통해 향상된 AI 상호 작용을 가능하게 합니다.

사용 가능한 도구

현재 서버는 두 가지 주요 도구를 구현하고 있습니다.

1. 퍼플렉시티_챗

전체 메시지 기록을 지원하는 고급 채팅 완성 도구입니다.

지엑스피1

2. perplexity_ask

빠른 질문을 위한 간소화된 단일 쿼리 인터페이스.

{
  "name": "perplexity_ask",
  "description": "Send a simple query to Perplexity AI",
  "parameters": {
    "query": "string - The question or prompt to send",
    "model": "string (optional) - One of: llama-3.1-sonar-small-128k-online, llama-3.1-sonar-large-128k-online, llama-3.1-sonar-huge-128k-online"
  }
}

설치

저장소를 복제합니다.
git clone https://github.com/yourusername/perplexity-mcp-server.git cd perplexity-mcp-server
종속성 설치:
npm install
.env 파일을 만듭니다.
PERPLEXITY_API_KEY=your-api-key-here
프로젝트를 빌드하세요:
npm run build

클로드 데스크톱 구성

이 서버를 Claude Desktop에 추가하려면 claude_desktop_config.json 업데이트하세요.

{
  "mcpServers": {
    //more servers...
    "perplexity": {
      "command": "node",
      "args": ["path\\to\\perplexity-mcp-server\\dist\\index.js"],
      "env": {
        "PERPLEXITY_API_KEY": "YOUR_PERPLEXITY_API_KEY"
      }
    }
    //more servers...
  }
}

구성 파일은 일반적으로 다음 위치에 있습니다.

윈도우: %APPDATA%/Claude/config/claude_desktop_config.json
macOS: ~/Library/Application Support/Claude/config/claude_desktop_config.json
리눅스: ~/.config/Claude/config/claude_desktop_config.json

개발

자동 재컴파일로 개발 서버를 시작합니다.

npm run dev

서버는 TypeScript를 사용하고 @modelcontextprotocol/sdk 패키지를 사용하여 MCP 프로토콜을 구현합니다.

건축학

핵심 구성 요소

PerplexityServer 클래스
- MCP 서버 프로토콜을 구현합니다
- 도구 등록 및 실행을 처리합니다.
- 오류 처리 및 서버 수명 주기를 관리합니다.
도구 시스템
- 모듈식 도구 정의
- 유형 안전 도구 핸들러
- 구조화된 입력 검증

기술적 세부 사항

유형 안전을 위해 TypeScript로 구축됨
MCP 구현을 위해 @modelcontextprotocol/sdk 사용합니다.
stdio 전송을 통해 통신합니다
환경 기반 구성

오류 처리

서버는 포괄적인 오류 처리를 구현합니다.

API 오류 보고
잘못된 도구 요청 처리
연결 오류 관리
프로세스 신호 처리

종속성

@modelcontextprotocol/sdk : ^1.0.3
dotenv : ^16.4.7
isomorphic-fetch : ^3.0.0

기여하다

저장소를 포크하세요
기능 브랜치를 생성합니다( git checkout -b feature/amazing-feature )
변경 사항을 커밋하세요( git commit -m 'Add some amazing feature' )
브랜치에 푸시( git push origin feature/amazing-feature )
풀 리퀘스트 열기

보안

API 키는 환경 변수를 통해 관리됩니다.
모든 도구 매개변수에 대한 입력 검증
오류 메시지는 출력 전에 정리됩니다.
MCP 프로토콜을 통한 프로세스 격리

특허

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

문제 해결

일반적인 문제 및 해결 방법:

서버를 찾을 수 없습니다
- claude_desktop_config.json 의 경로가 올바른지 확인하세요.
- 서버가 빌드되었는지 확인하세요( npm run build )
- Node.js가 PATH에 있는지 확인하세요
인증 오류
- .env에서 Perplexity API 키를 확인하세요.
- API 키에 필요한 권한이 있는지 확인하세요
도구 실행 오류
- 도구 매개변수가 스키마와 일치하는지 확인하세요.
- 네트워크 연결 확인
- 자세한 오류 메시지는 서버 로그를 검토하세요.

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

Claude가 Anthropic의 모델 컨텍스트 프로토콜을 통해 Perplexity AI의 언어 모델과 상호 작용할 수 있도록 하는 Node.js 구현으로, 고급 채팅 완성 및 빠른 쿼리를 위한 도구를 제공합니다.

Related Resources

Reddit Discussion about this server

Perplexity MCP Server