クエリの意図に基づいて自動的にモデルを選択する Perplexity の API を使用して Web 検索機能を提供する MCP サーバー。
Node.js (v14以上)
Perplexity API キー ( https://www.perplexity.ai/settings/apiで取得)
クロードデスクトップアプリ
Related MCP server: Perplexity MCP Server
このリポジトリをクローンします:
git clone https://github.com/RossH121/perplexity-mcp.git
cd perplexity-mcp依存関係をインストールします:
npm installサーバーを構築します。
npm run buildhttps://www.perplexity.ai/settings/apiから Perplexity API キーを取得します。
~/Library/Application Support/Claude/claude_desktop_config.jsonにある Claude の設定ファイルにサーバーを追加します。
{
"mcpServers": {
"perplexity-server": {
"command": "node",
"args": [
"/absolute/path/to/perplexity-mcp/build/index.js"
],
"env": {
"PERPLEXITY_API_KEY": "your-api-key-here",
"PERPLEXITY_MODEL": "sonar"
}
}
}
}/absolute/path/toリポジトリのクローンを作成した実際のパスに置き換えます。
サーバーはクエリの意図に基づいた自動モデル選択をサポートするようになりましたが、 PERPLEXITY_MODEL環境変数を使用してデフォルトのモデルを指定することもできます。利用可能なオプション：
sonar-deep-research - 分野を超えた広範な調査と専門家レベルの分析に特化しています
sonar-reasoning-pro - 高度な論理的推論と複雑な問題解決に最適化されています
sonar-reasoning - バランスの取れたパフォーマンスで推論タスクを実行するために設計されています
sonar-pro - 優れた検索機能と引用密度を備えた汎用モデル
sonar - 簡単なクエリを高速かつ効率的に実行
デフォルトのモデル (環境変数で指定) は、自動モデル選択のベースラインとして使用されます。
最新のモデルの価格と在庫状況については、 https://docs.perplexity.ai/guides/pricingをご覧ください。
サーバーを設定してClaudeを再起動すれば、Claudeに情報を検索するよう指示するだけで済みます。例えば：
「SpaceXの最新ニュースは何ですか？」
「シカゴの最高のレストランを検索」
「ジャズ音楽の歴史に関する情報を見つける」
「最近の AI 開発に関する詳細な調査分析が必要です」（sonar-deep-research を使用）
「この複雑な問題を論理的に理解するのを手伝ってください」（sonar-reasoning-pro を使用）
ClaudeはPerplexity検索ツールを自動的に使用して関連情報を検索し、返します。サーバーはクエリの意図に基づいて最適なモデルを自動的に選択します。
何らかの理由で検索ツールを使用しないことにした場合は、プロンプトの前に「Web を検索」を追加して強制的に検索を実行できます。
サーバーはクエリに基づいて最も適切な Perplexity モデルを自動的に選択します。
「深い研究」「包括的」「詳細」などの研究志向の用語を使用して、ソナーディープリサーチをトリガーします。
「解決する」「理解する」「複雑な問題」などの推論用語を使用して、sonar-reasoning-pro をトリガーします。
「クイック」「簡潔」「基本」などの簡単な言葉を使って軽量ソナーモデルを起動します
バランスの取れたパフォーマンスのために、一般的な検索用語はデフォルトで sonar-pro に設定されます。
各検索応答には、使用されたモデルとその理由に関する情報が含まれます。
このサーバーは、検索エクスペリエンスをカスタマイズするためのドメインフィルタリングをサポートしています。以下のコマンドを使用して、特定のドメインを許可またはブロックできます。
許可されたドメインを追加する: 「domain_filter ツールを使用して wikipedia.org を許可する」
ブロックされたドメインを追加する：「domain_filter ツールを使用して pinterest.com をブロックする」
現在のフィルターを表示: 「list_filters ツールを使用する」(ドメインと最新フィルターを表示)
すべてのフィルターをクリア: 「clear_filters ツールを使用する」(ドメインと最新フィルターの両方をクリア)
注：Perplexity APIは最大3つのドメインをサポートし、許可されたドメインが優先されます。ドメインフィルタリングには、この機能をサポートするPerplexity API層が必要です。
使用フローの例:
「domain_filter ツールを使用して wikipedia.org を許可してください」
「ドメインフィルターツールを使用してarxiv.orgを許可する」
「list_filtersツールを使用する」（設定を確認するため）
「量子コンピューティングの進歩を検索」 (検索結果では wikipedia.org と arxiv.org が優先されます)
新しさフィルターを使用して、検索結果を特定の時間枠に制限することができます。
最新フィルターの設定：「filter=hour で recency_filter ツールを使用する」（オプション：時間、日、週、月）
最新フィルターを無効にする: 「filter=none で recency_filter ツールを使用する」
これは、現在の出来事や最新ニュースなど、時間に敏感なクエリに特に役立ちます。
自動モデル選択はほとんどの場合にうまく機能しますが、どのモデルが使用されるかを手動で制御することもできます。
モデル情報の表示：「model_info ツールを使用する」
特定のモデルを設定する:「model=sonar-deep-research で model_info ツールを使用する」
自動選択に戻す: モデルをデフォルトモデルに戻します
使用例:
「model_infoツールを使用する」（利用可能なモデルと現在のステータスを確認する）
「model_info ツールを model=sonar-reasoning-pro とともに使用する」（推論モデルの使用を強制する）
「ピタゴラスの定理の数学的証明を探す」（sonar-reasoning-pro を使用します）
「model_infoツールでmodel=sonar-proを使用する」（自動選択に戻る）
サーバーを変更するには:
src/index.tsを編集する
npm run buildでリビルドする
変更をロードするにはClaudeを再起動してください
マサチューセッツ工科大学
Remove all domain filters (both allowed and blocked). Use when switching search contexts or starting fresh. Does not affect recency filter.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden. It effectively discloses key behavioral traits: it's a destructive operation (removes filters), specifies what gets affected (domain filters) and what doesn't (recency filter), and implies a reset context. However, it doesn't mention permissions, side effects, or response format, leaving some 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 extremely concise and well-structured in two sentences: the first states the purpose and scope, the second provides usage guidelines and exclusions. Every sentence adds clear value with zero waste, making it easy to parse and understand quickly.
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 tool's simplicity (0 parameters, no output schema, no annotations), the description is nearly complete. It covers purpose, usage, and behavioral aspects effectively. However, it lacks details on permissions or confirmation prompts, which could be relevant for a destructive operation, leaving minor room for improvement.
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?
The tool has 0 parameters with 100% schema description coverage, so the schema already fully documents the lack of inputs. The description adds no parameter-specific information, which is appropriate here. A baseline of 4 is applied as it compensates adequately for the zero-parameter case by focusing on usage context.
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 specific action ('Remove all domain filters') and specifies the scope ('both allowed and blocked'), distinguishing it from sibling tools like 'domain_filter' which likely manages individual filters. It goes beyond just restating the name by detailing what exactly gets cleared.
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 explicitly provides usage scenarios ('when switching search contexts or starting fresh') and clarifies exclusions ('Does not affect recency filter'), offering clear guidance on when to use this tool versus alternatives like 'recency_filter' or 'list_filters'.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Configure domain filtering for search results. Use 'allow' to prioritize trusted sources (e.g., documentation sites, academic domains) or 'block' to exclude unreliable sources. Maximum 20 domains total. Filters persist across searches until cleared.
| Name | Required | Description | Default |
|---|---|---|---|
| domain | Yes | Domain name without protocol. Examples: 'wikipedia.org', 'docs.python.org', 'arxiv.org'. For subdomains: 'api.example.com' | |
| action | Yes | 'allow' prioritizes this domain in results, 'block' excludes it completely |
Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
With no annotations provided, the description carries the full burden and does well by disclosing key behavioral traits: it specifies the maximum limit of 20 domains, persistence across searches until cleared, and the effect of actions ('allow' prioritizes, 'block' excludes). It lacks details on error handling or rate limits, but covers essential operational constraints.
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 appropriately sized and front-loaded, with every sentence adding value: the first states the purpose, the second explains usage with examples, and the third covers constraints and persistence. There is no wasted text, making it efficient and well-structured.
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 tool's moderate complexity (2 parameters, no output schema, no annotations), the description is largely complete: it explains what the tool does, how to use it, and key behaviors. It could improve by mentioning the tool's relationship to siblings like 'clear_filters' or expected output, but it adequately covers the core functionality and constraints.
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 100%, so the schema already documents both parameters fully. The description adds minimal value beyond the schema by reinforcing the purpose of 'allow' and 'block' actions, but does not provide additional syntax or format details. This meets the baseline for high schema coverage.
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 tool's purpose with specific verbs ('configure domain filtering') and resource ('search results'), distinguishing it from siblings like 'clear_filters' and 'list_filters' by focusing on configuration rather than management or listing. It specifies the exact function of setting up domain-based filters.
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 clear context on when to use this tool (e.g., to prioritize trusted sources or exclude unreliable ones) and mentions persistence across searches, but it does not explicitly state when not to use it or name alternatives like 'recency_filter' for other filtering needs. Usage is implied but not exhaustively defined against all siblings.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Display current filter configuration including allowed domains, blocked domains, and active recency setting. Useful for debugging search behavior.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
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 describes what information is displayed (filter configuration details) and hints at a read-only operation ('Display'), but doesn't specify output format, potential errors, or any side effects. It adds some context about debugging utility, but lacks details on permissions or rate limits.
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 two concise sentences that are front-loaded with the core purpose and followed by a utility note. Every word adds value without repetition or fluff, making it highly efficient and well-structured.
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 tool's low complexity (0 parameters, no annotations, no output schema), the description is reasonably complete for a read-only configuration display tool. It specifies what information is included and the debugging context, but lacks details on output format or error handling, which could be helpful for an agent.
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?
The input schema has 0 parameters with 100% coverage, so no parameter documentation is needed. The description appropriately doesn't discuss parameters, earning a baseline score of 4 for not introducing confusion or redundancy.
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 tool's purpose: 'Display current filter configuration' with specific components listed (allowed domains, blocked domains, recency setting). It uses a specific verb ('Display') and identifies the resource ('filter configuration'), but doesn't explicitly distinguish it from sibling tools like 'domain_filter' or 'recency_filter' that might modify these settings.
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 implied usage guidance by stating it's 'Useful for debugging search behavior,' suggesting it should be used when troubleshooting search issues. However, it doesn't explicitly state when to use this tool versus alternatives like 'search' or the various filter-modifying siblings, nor does it provide any exclusion criteria.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
View available Perplexity models and their specializations, or manually override model selection. By default, models are auto-selected based on query intent (research, reasoning, general search).
| Name | Required | Description | Default |
|---|---|---|---|
| model | No | Optional: Override auto-selection. 'sonar-deep-research' for comprehensive analysis, 'sonar-reasoning-pro' for complex logic, 'sonar' for quick lookups |
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 effectively describes the tool's behavior: viewing available models, their specializations, and the ability to override auto-selection. It explains the default behavior (auto-selection based on query intent) and the override capability, though it doesn't specify what happens when no parameter is provided (e.g., whether it returns a list or default info).
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 appropriately sized and front-loaded with the core purpose in the first clause. Both sentences earn their place: the first establishes what the tool does, and the second explains the default behavior and context. There's no wasted language or redundancy.
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 tool's moderate complexity (1 optional parameter with full schema coverage, no output schema), the description is mostly complete. It covers purpose, usage, and parameter context well. However, it doesn't specify what the tool returns (e.g., a list of models with details or just confirmation), which would be helpful since there's no output schema.
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 100%, so the baseline is 3. The description adds value by explaining the context of the parameter: 'manually override model selection' and 'By default, models are auto-selected based on query intent'. This provides semantic meaning beyond the schema's enum descriptions, helping the agent understand when and why to use the parameter.
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 tool's purpose with specific verbs ('View available Perplexity models and their specializations, or manually override model selection') and distinguishes it from sibling tools like 'search' or 'list_filters' by focusing on model information and selection rather than filtering or searching operations.
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 explicitly provides usage guidance: 'By default, models are auto-selected based on query intent (research, reasoning, general search)' and indicates when to use the override parameter. This clearly distinguishes it from the default auto-selection behavior and helps the agent understand when manual selection is appropriate.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Control the time window for search results. Essential for time-sensitive queries like news, updates, or recent developments. Filter persists until changed.
| Name | Required | Description | Default |
|---|---|---|---|
| filter | Yes | Time window: 'hour' for breaking news, 'day' for daily updates, 'week' for recent developments, 'month' for broader recent context, 'none' to include all time periods |
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 reveals important behavioral traits: the filter persists until changed (stateful behavior), and it's for search results (context of application). However, it doesn't mention potential side effects, error conditions, or what happens when the filter is applied.
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 perfectly concise with three sentences that each earn their place: states the core function, provides usage context, and reveals important behavioral trait (persistence). No wasted words, 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 tool's moderate complexity (stateful filter setting), no annotations, and no output schema, the description does reasonably well. It explains what the tool does, when to use it, and a key behavioral aspect (persistence). However, it doesn't describe what the tool returns or potential error conditions, leaving some gaps in completeness.
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?
With 100% schema description coverage and only 1 parameter, the schema already fully documents the parameter. The description adds some value by explaining why you'd use different time windows ('breaking news', 'daily updates', etc.), but doesn't provide additional syntax or format details beyond what's in the schema. For a single-parameter tool with excellent schema coverage, this is above baseline.
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 tool's purpose with specific verbs ('Control the time window for search results') and distinguishes it from siblings by focusing on time-based filtering. It explicitly mentions what it does (sets a time window filter) rather than just restating the name.
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 clear context for when to use this tool ('Essential for time-sensitive queries like news, updates, or recent developments'), but doesn't explicitly mention when NOT to use it or name specific alternatives among the sibling tools. It implies usage scenarios but lacks explicit exclusions.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Web search via Perplexity AI with automatic model selection. Returns cited sources with summaries. The search uses only the query text (not conversation history). Best for: current events, factual research, technical documentation, comparative analysis.
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Direct search query. Be specific with 2-3 context words, use expert terminology. Good: 'Compare 2025 React vs Vue performance for enterprise apps'. Bad: 'tell me about frameworks'. Tips: Use 'site:domain.com' for specific sites, include years for recent info, add 'analyze/compare/explain' for reasoning tasks. | |
| stream | No | Enable streaming responses (default: false) |
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 effectively describes key traits: the search mechanism ('via Perplexity AI with automatic model selection'), output format ('returns cited sources with summaries'), and input constraints ('uses only the query text'). However, it lacks details on rate limits, authentication needs, or error handling, which are common for such tools.
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 appropriately sized and front-loaded, with every sentence earning its place. It starts with the core functionality, adds key features, and ends with usage guidelines, all in a concise and structured manner without unnecessary details.
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 tool's complexity (a search tool with behavioral nuances) and no output schema, the description is mostly complete. It covers purpose, usage, and key behaviors, but could benefit from mentioning response format details or potential limitations. However, it compensates well with clear guidelines and transparency.
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 100%, so the schema already documents both parameters thoroughly. The description does not add meaning beyond what the schema provides for parameters; it focuses on overall tool behavior instead. Baseline 3 is appropriate as the schema handles parameter documentation adequately.
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 tool's purpose with specific verbs ('web search via Perplexity AI') and resources ('returns cited sources with summaries'). It distinguishes itself from potential siblings by specifying 'automatic model selection' and 'uses only the query text (not conversation history)', making its scope explicit and differentiated.
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 explicit usage guidelines with 'Best for: current events, factual research, technical documentation, comparative analysis.' This clearly indicates when to use this tool versus alternatives, offering specific contexts and exclusions (e.g., not for conversational history-based queries).
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
v1.0.0clear_filtersdomain_filterlist_filtersmodel_inforecency_filtersearchScored across 6 tools
Each tool has a clearly distinct purpose with no overlap: clear_filters removes filters, domain_filter configures domains, list_filters displays current settings, model_info shows models, recency_filter controls time windows, and search performs web searches. The descriptions reinforce these unique roles, making misselection unlikely.
All tool names follow a consistent verb_noun pattern with snake_case (e.g., clear_filters, domain_filter, list_filters, model_info, recency_filter, search). The naming is predictable and readable throughout, with no deviations or mixed conventions.
With 6 tools, this server is well-scoped for its purpose of configuring and executing Perplexity AI searches. Each tool earns its place by covering essential aspects like filtering, model selection, and search execution, without being overly sparse or bloated.
The tool set provides complete coverage for the domain of Perplexity AI search configuration and execution. It includes setup (filters, model info), control (recency, domain filters), status (list_filters), and core functionality (search), with no obvious gaps that would cause agent failures.
Hosted MCP server connecting claude.ai, ChatGPT and other AI apps to your own computer
Docs: https://docs.keenable.ai/mcp-server Keenable is a free, remote MCP server that gives agents access to the web index. Search the web with ranked results and date/site filters, then fetch any indexed page as clean markdown. Works out of the box with no account or API key.
Augments MCP Server - A comprehensive framework documentation provider for Claude Code
