Perplexity MCP Server

आधिकारिक

एक MCP सर्वर जो Perplexity के Sonar API से जुड़ता है, संवादात्मक AI में वास्तविक समय में वेब-व्यापी शोध को सक्षम बनाता है।

GitHub

2.4k

दस्तावेज़

Perplexity API प्लेटफ़ॉर्म MCP सर्वर

Perplexity API प्लेटफ़ॉर्म के लिए आधिकारिक MCP सर्वर कार्यान्वयन, जो AI सहायकों को Sonar मॉडल और Search API के माध्यम से वास्तविक-समय वेब खोज, तर्क और अनुसंधान क्षमताएँ प्रदान करता है।

उपलब्ध उपकरण

perplexity_search

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

perplexity_ask

sonar-pro मॉडल का उपयोग करके वास्तविक-समय वेब खोज के साथ सामान्य-उद्देश्यीय संवादी AI। त्वरित प्रश्नों और रोज़मर्रा की खोजों के लिए बढ़िया।

perplexity_research

sonar-deep-research मॉडल का उपयोग करके गहन, व्यापक अनुसंधान। संपूर्ण विश्लेषण और विस्तृत रिपोर्ट के लिए आदर्श।

perplexity_reason

sonar-reasoning-pro मॉडल का उपयोग करके उन्नत तर्क और समस्या-समाधान। जटिल विश्लेषणात्मक कार्यों के लिए उपयुक्त।

[!TIP] perplexity_reason और perplexity_research के लिए एक वैकल्पिक पैरामीटर के रूप में उपलब्ध: strip_thinking

प्रतिक्रिया से <think>...</think> टैग हटाने के लिए true पर सेट करें, जिससे संदर्भ टोकन बचते हैं। डिफ़ॉल्ट: false

कॉन्फ़िगरेशन

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

API पोर्टल से अपनी Perplexity API कुंजी प्राप्त करें
नीचे दिए गए कॉन्फ़िगरेशन में your_key_here को अपनी API कुंजी से बदलें
(वैकल्पिक) टाइमआउट सेट करें: PERPLEXITY_TIMEOUT_MS=600000 (डिफ़ॉल्ट: 5 मिनट)
(वैकल्पिक) कस्टम बेस URL सेट करें: PERPLEXITY_BASE_URL=https://your-custom-url.com (डिफ़ॉल्ट: https://api.perplexity.ai)
(वैकल्पिक) लॉग स्तर सेट करें: 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

Cursor, Claude Desktop, Kiro, Windsurf, और VS Code

अधिकांश क्लाइंट को उनके क्लाइंट कॉन्फ़िग में समान 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 पर सुलभ होगा

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

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 पर जाएँ या एक मुद्दा दर्ज करें।