Perplexity AI MCP Server
Perplexity AI MCP 서버
Perplexity AI의 API를 통합한 MCP 서버 구현으로, 다양한 모델 옵션을 통해 고급 검색 기능을 제공합니다.
특징
Perplexity AI 모델을 사용하여 검색
모든 공식 Sonar 모델 지원
구성 가능한 결과 수
자세한 오류 처리 및 로깅
MCP Inspector 호환
Related MCP server: PPX-MCP
사용 가능한 모델
소나-리즈닝-프로(127k 컨텍스트)
소나 추론(127k 컨텍스트)
소나프로(20만 컨텍스트)
소나(127k 컨텍스트)
설치
지엑스피1
구성
API 키
Perplexity AI 계정 에 가입하세요
대시보드에서 API 키를 받으세요
환경 변수를 설정합니다.
export PERPLEXITY_API_KEY=your_api_key_here용법
직접 실행
node dist/index.js
# or if you made it executable
./dist/index.js개발
pnpm devMCP Inspector로 테스트
pnpm inspect도구 참조
퍼플렉시티_검색
Perplexity AI의 모델을 사용하여 검색을 수행합니다.
매개변수:
query(문자열, 필수): 검색 쿼리model(문자열, 선택 사항): 사용할 모델(기본값: "sonar")사용 가능한 옵션: sonar-reasoning-pro, sonar-reasoning, sonar-pro, sonar
count(숫자, 선택 사항): 결과 수(1-10, 기본값: 5)
개발
프로젝트 구조
src/perplexity/
├── index.ts # Main server implementation
├── lib/
│ └── logger.ts # Logging configuration
└── adr.md # Architectural decisions벌채 반출
로그는 프로젝트 루트 디렉토리의 perplexity-mcp.log 에 기록됩니다.
특허
MIT
기여하다
저장소를 포크하세요
기능 브랜치를 생성하세요
변경 사항을 커밋하세요
지점으로 밀어 넣기
새로운 풀 리퀘스트 만들기
Available Tools
1 toolperplexity_searchC
Search using Perplexity AI's models with context-aware responses and citations
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| model | No | Model to use (sonar-reasoning-pro, sonar-reasoning, sonar-pro, sonar) | sonar |
| count | No |
TDQS
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden of behavioral disclosure. It mentions 'context-aware responses and citations', which adds some value about output characteristics, but fails to address critical aspects like whether this is a read-only operation, potential rate limits, authentication requirements, or error handling. For a search tool with zero annotation coverage, this leaves significant gaps.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The description is a single, efficient sentence that conveys the core functionality without unnecessary words. It's appropriately sized and front-loaded with the essential information.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given the complexity of a search tool with 3 parameters, no annotations, and no output schema, the description is insufficient. It doesn't explain what the tool returns (beyond mentioning 'responses and citations'), doesn't cover parameter meanings beyond what little the schema provides, and leaves behavioral aspects unclear. This is inadequate for proper tool selection and invocation.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema description coverage is only 33% (only the 'model' parameter has a description), so the description needs to compensate but doesn't mention any parameters. The baseline would be lower, but since there are only 3 parameters and one is well-documented in the schema, the description's failure to add parameter context results in a minimal viable score.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description clearly states the action ('Search') and the resource ('Perplexity AI's models'), specifying it provides 'context-aware responses and citations'. However, with no sibling tools mentioned, it cannot demonstrate differentiation from alternatives, so it doesn't reach the highest score.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The description provides no guidance on when to use this tool versus alternatives, prerequisites, or exclusions. It only states what the tool does without contextual usage information.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
1 tool update
v1.0.0- First observed
perplexity_search
TDQS
Scored across 1 tool
With only one tool, there is no possibility of ambiguity or overlap between tools. The tool's purpose is clearly defined as searching using Perplexity AI's models, making it distinct by default.
The single tool name 'perplexity_search' follows a clear and consistent verb_noun pattern (search as the verb, perplexity as a modifier). With only one tool, naming consistency is inherently perfect as there are no other tools to compare against.
A single tool is generally too few for most server purposes, as it limits functionality and flexibility. For a search-focused server, additional tools like filtering, citation management, or model selection might be expected to provide a more complete experience.
The server's domain appears to be search using Perplexity AI, but with only one search tool, there are significant gaps. Missing operations could include advanced search parameters, result refinement, citation handling, or integration with other Perplexity features, making the surface incomplete for typical search workflows.
Maintenance
Related MCP Connectors
An MCP server that integrates with Discord to provide AI-powered features.
Driflyte MCP server which lets AI assistants query topic-specific knowledge from web and GitHub.
MCP server for AI dialogue using various LLM models via AceDataCloud
MCP server for OpenAI API (chat completions, image generation, embeddings) via AceDataCloud
Related MCP Servers
- MIT
- AlicenseAqualityDmaintenanceAn unofficial MCP server for Perplexity AI that leverages Pro subscriptions and browser cookies to enable real-time web searches and model selection without an API key. It provides tools for performing queries, listing available models, and automating the login process to manage authentication.429 npmMIT
- AlicenseNot gradedqualityFmaintenanceAn MCP server that integrates with Poe's API to provide AI-powered search and research tools from Perplexity, Reka, Exa, and Linkup.19 npm8MIT
- AlicenseNot gradedqualityDmaintenanceAn MCP server that enables AI agents to perform search-augmented queries and deep multi-source research using the Perplexity API.59 npm25Apache 2.0