local-only server

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

Integrations

Provides support for storing Perplexity API keys securely in environment variables for better security practices when sharing code.
Allows Claude to perform web-based research through Perplexity AI's API, providing answers with citations. Supports configuration of parameters like temperature, max tokens, domain filtering, and recency filtering.

Claude Desktop용 Perplexity 도구

Perplexity AI의 API를 Claude Desktop과 통합하는 맞춤형 MCP 도구를 사용하면 Claude가 웹 기반 연구를 수행하고 인용을 통해 답변을 제공할 수 있습니다.

설치 전제 조건

Git 설치:
- Mac의 경우:
  - 먼저 터미널에 GXP1을 붙여넣어 Homebrew를 설치하세요.
  - 그런 다음 Git을 설치하세요: GXP2
- Windows의 경우:
  - git-scm.com 에서 Git을 다운로드하세요
  - 설치 프로그램을 실행하세요
Node.js 설치:
- Mac의 경우:
  brew install node
- Windows의 경우:
  - nodejs.org 에서 다운로드
  - 설치 프로그램을 실행하세요
다음을 실행하여 설치를 확인하세요.

git --version
node --version

도구 설치

저장소를 복제합니다

git clone https://github.com/letsbuildagent/perplexity-tool
cd perplexity-tool

종속성 설치

npm install

API 키 설정

두 가지 옵션이 있습니다.

옵션 1(빠른 설정):

server.js 를 엽니다
다음 줄을 찾으세요:

const PERPLEXITY_API_KEY = "YOUR-API-KEY-HERE";

Perplexity API 키로 교체하세요

옵션 2(모범 사례):

.env 파일을 만듭니다.
# On Mac/Linux: touch .env open .env # On Windows: notepad .env
또는 텍스트 편집기에서 .env 라는 이름의 새 파일을 만드세요.
.env 파일에 API 키를 추가합니다.
PERPLEXITY_API_KEY=your-api-key-here
dotenv 설치:
npm install dotenv
server.js 업데이트:
import 'dotenv/config' const PERPLEXITY_API_KEY = process.env.PERPLEXITY_API_KEY;

Claude Desktop 구성

~/Library/Application Support/Claude/claude_desktop_config.json 엽니다.
다음 구성을 추가합니다.

{
  "mcpServers": {
    "perplexity-tool": {
      "command": "node",
      "args": [
        "/full/path/to/perplexity-tool/server.js"
      ]
    }
  }
}

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

Claude Desktop을 다시 시작하세요

용법

설치가 완료되면 Claude를 통해 다음과 같은 명령을 사용하여 도구를 사용할 수 있습니다.

"Perplexity에 AI의 최근 발전에 대해 물어보세요"
"Perplexity를 사용하여 양자 컴퓨팅의 역사를 연구하세요"
"지난 한 달 동안의 기후 변화에 대한 정보를 Perplexity에서 검색하세요"

고급 옵션

추가 매개변수를 지정할 수 있습니다.

temperature : 반응의 무작위성을 제어합니다(0-2)
max_tokens : 응답 길이를 제한합니다.
search_domain_filter : 특정 도메인으로 검색을 제한합니다.
search_recency_filter : 기간(일/주/월/년)별로 필터링합니다.

문제 해결

Git을 찾을 수 없습니다:
- Git을 올바르게 설치했는지 확인하세요
- 터미널을 다시 시작해 보세요
- Mac에서는 Homebrew가 PATH에 있는지 확인하세요.
Node.js 오류:
- node --version 으로 Node.js 설치를 확인하세요.
- Node.js를 다시 설치해보세요
API 키 문제:
- API 키를 올바르게 복사했는지 확인하세요.
- .env 파일에 추가 공백이 없는지 확인하세요.
- 옵션 2를 사용하는 경우 dotenv가 설치되어 있는지 확인하세요.
Claude에 도구가 나타나지 않음:
- claude_desktop_config.json에서 경로를 확인하세요
- 경로가 server.js 파일을 가리키는지 확인하세요.
- Claude Desktop을 다시 시작하세요
- 콘솔에서 오류 메시지를 확인하세요.

특허

MIT

보안 참고 사항

코드를 공유하거나 공개할 계획이라면:

API 키를 Git에 커밋하지 마세요
.env 메서드를 사용하세요(옵션 2)
.gitignore 파일에 .env를 추가하세요.

You must be authenticated.

A

security – no known vulnerabilities

A

license - permissive license

A

quality - confirmed to work

Tools

ask_perplexity