Perplexity Ask MCP Server

Perplexity API Platform MCP सर्वर

     

Perplexity API Platform के लिए आधिकारिक MCP सर्वर कार्यान्वयन, जो AI सहायकों को Agent API और Search API के माध्यम से वास्तविक समय में वेब खोज, तर्क और शोध क्षमताएँ प्रदान करता है।

रिमोट MCP सर्वर

रिमोट MCP सर्वर Perplexity द्वारा होस्ट किया गया है और यह शुरू करने का सबसे आसान तरीका है: समान टूल, कुछ भी इंस्टॉल या अपडेट करने की आवश्यकता नहीं। इस पृष्ठ के शीर्ष पर Cursor और VS Code बटन एक क्लिक से इससे जुड़ते हैं। यदि आपका MCP क्लाइंट अभी तक रिमोट सर्वर का समर्थन नहीं करता है, तो नीचे स्थानीय सर्वर सेटअप पर जाएँ। अपनी Perplexity API कुंजी के साथ Streamable HTTP पर कनेक्ट करें:

https://api.perplexity.ai/mcp

Claude Code के लिए:

claude mcp add --transport http perplexity https://api.perplexity.ai/mcp --header "Authorization: Bearer YOUR_API_KEY"

मैन्युअल Cursor/VS Code कॉन्फ़िगरेशन, Anthropic API से उपयोग, और अन्य क्लाइंट्स के लिए सेटअप हेतु MCP एकीकरण दस्तावेज़ देखें।

स्थानीय MCP सर्वर

अपनी API कुंजी प्राप्त करें

1. API पोर्टल से अपनी Perplexity API कुंजी प्राप्त करें
2. नीचे दिए गए कॉन्फ़िगरेशन में your_key_here को अपनी API कुंजी से बदलें
3. (वैकल्पिक) टाइमआउट सेट करें: PERPLEXITY_TIMEOUT_MS=600000 (डिफ़ॉल्ट: 5 मिनट)
4. (वैकल्पिक) कस्टम बेस URL सेट करें: PERPLEXITY_BASE_URL=https://your-custom-url.com (डिफ़ॉल्ट: https://api.perplexity.ai)
5. (वैकल्पिक) लॉग स्तर सेट करें: PERPLEXITY_LOG_LEVEL=DEBUG|INFO|WARN|ERROR (डिफ़ॉल्ट: ERROR)

Claude Code

claude mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

या प्लगइन के माध्यम से इंस्टॉल करें:

export PERPLEXITY_API_KEY="your_key_here"
claude
# Then run: /plugin marketplace add perplexityai/modelcontextprotocol
# Then run: /plugin install perplexity

Codex

codex mcp add perplexity --env PERPLEXITY_API_KEY="your_key_here" -- npx -y @perplexity-ai/mcp-server

अन्य MCP क्लाइंट्स

अधिकांश क्लाइंट्स को उनके क्लाइंट कॉन्फ़िगरेशन में समान mcpServers रैपर का उपयोग करके मैन्युअल रूप से कॉन्फ़िगर किया जा सकता है (जैसा कि Cursor के लिए दिखाया गया है)। यदि किसी क्लाइंट का स्कीमा अलग है, तो सटीक रैपर प्रारूप के लिए उसके दस्तावेज़ देखें।

मैन्युअल सेटअप के लिए, ये सभी क्लाइंट समान mcpServers संरचना का उपयोग करते हैं:

क्लाइंट	कॉन्फ़िग फ़ाइल
Cursor	~/.cursor/mcp.json
Claude Desktop	claude_desktop_config.json
Kiro	.kiro/settings/mcp.json
Windsurf	~/.codeium/windsurf/mcp_config.json
VS Code	.vscode/mcp.json

{
  "mcpServers": {
    "perplexity": {
      "command": "npx",
      "args": ["-y", "@perplexity-ai/mcp-server"],
      "env": {
        "PERPLEXITY_API_KEY": "your_key_here"
      }
    }
  }
}

प्रॉक्सी सेटअप (कॉर्पोरेट नेटवर्क के लिए)

यदि आप इस सर्वर को कार्यस्थल पर चला रहे हैं—विशेष रूप से कंपनी फ़ायरवॉल या प्रॉक्सी के पीछे—तो आपको प्रोग्राम को बताना पड़ सकता है कि अपने नेटवर्क के प्रॉक्सी के माध्यम से इंटरनेट ट्रैफ़िक कैसे भेजें। इन चरणों का पालन करें:

1. अपनी प्रॉक्सी जानकारी प्राप्त करें

• अपने IT विभाग से अपना HTTPS प्रॉक्सी पता और पोर्ट पूछें।
• आपको उपयोगकर्ता नाम और पासवर्ड की भी आवश्यकता हो सकती है।

2. प्रॉक्सी पर्यावरण चर सेट करें

Perplexity MCP के लिए सबसे आसान और सबसे विश्वसनीय तरीका PERPLEXITY_PROXY का उपयोग करना है। उदाहरण के लिए:

export PERPLEXITY_PROXY=https://your-proxy-host:8080

यदि आपके प्रॉक्सी को उपयोगकर्ता नाम और पासवर्ड की आवश्यकता है, तो उपयोग करें:

export PERPLEXITY_PROXY=https://username:password@your-proxy-host:8080

3. वैकल्पिक: मानक पर्यावरण चर

यदि आप मानक चर का उपयोग करना चाहते हैं, तो हम HTTPS_PROXY और HTTP_PROXY का समर्थन करते हैं।

[!NOTE] सर्वर प्रॉक्सी सेटिंग्स को इस क्रम में जाँचता है: PERPLEXITY_PROXY → HTTPS_PROXY → HTTP_PROXY। यदि कोई सेट नहीं है, तो यह सीधे इंटरनेट से जुड़ता है। URL में https:// शामिल होना चाहिए। विशिष्ट पोर्ट 8080, 3128, और 80 हैं।

स्व-होस्टेड HTTP मोड

क्लाउड या साझा परिनियोजन के लिए, सर्वर को HTTP मोड में चलाएँ।

पर्यावरण चर

चर	विवरण	डिफ़ॉल्ट
PERPLEXITY_API_KEY	आपकी Perplexity API कुंजी	आवश्यक
PERPLEXITY_BASE_URL	API अनुरोधों के लिए कस्टम बेस URL	https://api.perplexity.ai
PORT	HTTP सर्वर पोर्ट	8080
BIND_ADDRESS	बाइंड करने के लिए नेटवर्क इंटरफ़ेस। डिफ़ॉल्ट रूप से लूपबैक। सभी इंटरफ़ेस पर एक्सपोज़ करने के लिए 0.0.0.0 पर सेट करें।	127.0.0.1
ALLOWED_ORIGINS	CORS ओरिजिन (अल्पविराम से अलग)। डिफ़ॉल्ट रूप से खाली (कोई क्रॉस-ओरिजिन ब्राउज़र अनुरोध नहीं)। स्पष्ट अनुमत सूची (जैसे https://app.example.com) या किसी भी ओरिजिन की अनुमति के लिए * पर सेट करें।	(खाली)
ALLOWED_HOSTS	स्वीकार करने के लिए अतिरिक्त Host हेडर मान (अल्पविराम से अलग)। PORT पर लूपबैक होस्ट हमेशा अनुमत होते हैं। 0.0.0.0 पर बाइंड करते समय सार्वजनिक होस्टनाम जोड़ें।	(केवल लूपबैक)

Docker

docker build -t perplexity-mcp-server .
docker run -p 8080:8080 -e PERPLEXITY_API_KEY=your_key_here perplexity-mcp-server

Node.js

export PERPLEXITY_API_KEY=your_key_here
npm install && npm run build && npm run start:http

सर्वर http://localhost:8080/mcp पर सुलभ होगा

उपलब्ध टूल

perplexity_search

Perplexity Search API का उपयोग करके सीधी वेब खोज। मेटाडेटा के साथ रैंक किए गए खोज परिणाम लौटाता है, वर्तमान जानकारी खोजने के लिए उपयुक्त। रीसेंसी फ़िल्टर (search_recency_filter) और डोमेन प्रतिबंध (search_domain_filter) का समर्थन करता है।

perplexity_ask

Agent API fast प्रीसेट द्वारा समर्थित वास्तविक समय वेब खोज के साथ सामान्य-उद्देश्य संवादात्मक AI। त्वरित प्रश्नों और रोज़मर्रा की खोजों के लिए बढ़िया।

perplexity_research

Agent API high प्रीसेट द्वारा समर्थित गहन, व्यापक शोध। गहन विश्लेषण और विस्तृत रिपोर्ट के लिए आदर्श। रन में मिनट लग सकते हैं; सर्वर रन को स्ट्रीम करता है और अनुरोध करने वाले क्लाइंट्स को प्रगति की रिपोर्ट करता है।

perplexity_reason

Agent API medium प्रीसेट द्वारा समर्थित उन्नत तर्क और समस्या-समाधान। जटिल विश्लेषणात्मक कार्यों के लिए उपयुक्त।

[!NOTE] प्रीसेट प्रबंधित कॉन्फ़िगरेशन हैं (मॉडल, खोज सेटअप, चरण बजट) जिन्हें Perplexity समय के साथ ट्यून करता रहता है; प्रीसेट गाइड देखें। इस सर्वर के पुराने संस्करणों ने लीगेसी sonar-pro, sonar-reasoning-pro, और sonar-deep-research मॉडल को कॉल किया और strip_thinking / reasoning_effort पैरामीटर स्वीकार किए। वे पैरामीटर अब टूल स्कीमा का हिस्सा नहीं हैं और भेजे जाने पर अनदेखा कर दिए जाते हैं; Agent API कोई <think> टैग उत्पन्न नहीं करता है।

लाइब्रेरी के रूप में उपयोग करें

पैकेज अपने स्वयं के Node प्रक्रिया में एम्बेड करने के लिए सर्वर फ़ैक्टरी भी निर्यात करता है:

import { createPerplexityServer } from "@perplexity-ai/mcp-server";

// Single-tenant: reads PERPLEXITY_API_KEY from the environment.
const server = createPerplexityServer("my-service");

// Multi-tenant hosts resolve the key per call instead. When a provider is
// set, the environment variable is never consulted, and a provider that
// returns no key fails the call rather than falling back.
const tenantServer = createPerplexityServer("my-service", {
  apiKey: () => currentRequestApiKey,
});

लौटाए गए सर्वर को किसी भी MCP ट्रांसपोर्ट (stdio, streamable HTTP, in-memory) पर माउंट करें।

समस्या निवारण

• API कुंजी समस्याएँ: सुनिश्चित करें कि PERPLEXITY_API_KEY सही ढंग से सेट है
• कनेक्शन त्रुटियाँ: अपना इंटरनेट कनेक्शन और API कुंजी की वैधता जाँचें
• टूल नहीं मिला: सुनिश्चित करें कि पैकेज इंस्टॉल है और कमांड पथ सही है
• टाइमआउट त्रुटियाँ: बहुत लंबे शोध प्रश्नों के लिए, PERPLEXITY_TIMEOUT_MS को उच्च मान पर सेट करें
• प्रॉक्सी समस्याएँ: अपना PERPLEXITY_PROXY या HTTPS_PROXY सेटअप सत्यापित करें और सुनिश्चित करें कि api.perplexity.ai आपके फ़ायरवॉल द्वारा अवरुद्ध नहीं है।
• EOF / इनिशियलाइज़ त्रुटियाँ: कुछ सख्त MCP क्लाइंट विफल हो जाते हैं क्योंकि npx stdout पर इंस्टॉलेशन संदेश लिखता है। इस आउटपुट को दबाने के लिए npx -y के बजाय npx -yq का उपयोग करें।

सहायता के लिए, community.perplexity.ai पर जाएँ या एक समस्या दर्ज करें।

---