Perplexity MCP 서버

개요

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

Related MCP server: Perplexity MCP Server

사용 가능한 도구

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

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 키에 필요한 권한이 있는지 확인하세요
도구 실행 오류
- 도구 매개변수가 스키마와 일치하는지 확인하세요.
- 네트워크 연결 확인
- 자세한 오류 메시지는 서버 로그를 검토하세요.