Tavily

Tavily MCP सर्वर

Tavily MCP सर्वर प्रदान करता है:

• खोज, निकालें, मानचित्र, क्रॉल उपकरण
• tavily-search उपकरण के माध्यम से रीयल-टाइम वेब खोज क्षमताएँ
• tavily-extract उपकरण के माध्यम से वेब पेजों से बुद्धिमान डेटा निष्कर्षण
• शक्तिशाली वेब मैपिंग उपकरण जो वेबसाइट का संरचित मानचित्र बनाता है
• वेब क्रॉलर जो व्यवस्थित रूप से वेबसाइटों का अन्वेषण करता है

📚 सहायक संसाधन

• Tavily MCP को Neo4j MCP सर्वर के साथ संयोजित करने पर ट्यूटोरियल
• VS Code में Tavily MCP को Cline के साथ एकीकृत करने पर ट्यूटोरियल

रिमोट MCP सर्वर

स्थानीय रूप से चलाने के बजाय सीधे Tavily के रिमोट MCP सर्वर से कनेक्ट करें। यह स्थानीय स्थापना या कॉन्फ़िगरेशन की आवश्यकता के बिना एक सहज अनुभव प्रदान करता है।

बस अपनी Tavily API कुंजी के साथ रिमोट MCP सर्वर URL का उपयोग करें:

https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key> 

अपनी Tavily API कुंजी tavily.com से प्राप्त करें।

वैकल्पिक रूप से, यदि MCP क्लाइंट इसका समर्थन करता है, तो आप Authorization हेडर के माध्यम से अपनी API कुंजी पास कर सकते हैं:

Authorization: Bearer <your-api-key>

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

{"include_images":true, "search_depth": "basic", "max_results": 10}

Claude Code से कनेक्ट करें

Claude Code Claude के लिए Anthropic का आधिकारिक CLI उपकरण है। आप claude mcp add कमांड का उपयोग करके Tavily MCP सर्वर जोड़ सकते हैं। प्रमाणित करने के दो तरीके हैं:

विकल्प 1: URL में API कुंजी

अपनी API कुंजी सीधे URL में पास करें। <your-api-key> को अपनी वास्तविक Tavily API कुंजी से बदलें:

claude mcp add --transport http tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

विकल्प 2: OAuth प्रमाणीकरण प्रवाह

URL में API कुंजी के बिना सर्वर जोड़ें:

claude mcp add --transport http tavily https://mcp.tavily.com/mcp

जोड़ने के बाद, आपको प्रमाणीकरण प्रवाह पूरा करना होगा:

1. Claude Code शुरू करने के लिए claude चलाएँ
2. MCP सर्वर प्रबंधन खोलने के लिए /mcp टाइप करें
3. Tavily सर्वर चुनें और प्रमाणीकरण प्रक्रिया पूरी करें

सुझाव: Tavily MCP सर्वर को अपनी सभी परियोजनाओं में वैश्विक रूप से उपलब्ध कराने के लिए किसी भी कमांड में --scope user जोड़ें:

claude mcp add --transport http --scope user tavily https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>

एक बार कॉन्फ़िगर हो जाने पर, आपके पास Tavily खोज, निकालें, मानचित्र और क्रॉल उपकरणों तक पहुँच होगी।

Cursor से कनेक्ट करें

⬆️ Cursor में जोड़ें ⬆️ बटन पर क्लिक करें, यह आपके लिए अधिकांश काम कर देगा लेकिन आपको अपनी API-KEY जोड़ने के लिए कॉन्फ़िगरेशन को संपादित करना होगा। आप यहाँ Tavily API कुंजी प्राप्त कर सकते हैं।

एक बार जब आप बटन पर क्लिक करते हैं तो आपको Cursor पर पुनर्निर्देशित किया जाना चाहिए ...

चरण 1

इंस्टॉल बटन पर क्लिक करें

चरण 2

आपको देखना चाहिए कि MCP अब स्थापित हो गया है, यदि नीली स्लाइड पहले से चालू नहीं है, तो इसे मैन्युअल रूप से चालू करें। आपको अपनी स्वयं की Tavily API कुंजी शामिल करने के लिए कॉन्फ़िगरेशन को संपादित करने की भी आवश्यकता है।

चरण 3

फिर आपको अपनी mcp.json फ़ाइल पर पुनर्निर्देशित किया जाएगा जहाँ आपको your-api-key जोड़ना होगा।

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx -y mcp-remote https://mcp.tavily.com/mcp/?tavilyApiKey=<your-api-key>",
      "env": {}
    }
  }
}

रिमोट MCP सर्वर OAuth प्रवाह

Tavily रिमोट MCP सर्वर सुरक्षित OAuth प्रमाणीकरण का समर्थन करता है, जिससे आप संगत क्लाइंट के साथ सहजता से कनेक्ट और अधिकृत कर सकते हैं।

OAuth प्रमाणीकरण कैसे सेट करें

A. MCP इंस्पेक्टर का उपयोग करना:

• MCP इंस्पेक्टर खोलें और "Open Auth Settings" पर क्लिक करें।
• OAuth प्रवाह चुनें और इन चरणों को पूरा करें:
  1. मेटाडेटा खोज
  2. क्लाइंट पंजीकरण
  3. प्राधिकरण तैयार करना
  4. प्राधिकरण का अनुरोध करें और प्राधिकरण कोड प्राप्त करें
  5. टोकन अनुरोध
  6. प्रमाणीकरण पूर्ण

एक बार समाप्त होने पर, आपको एक एक्सेस टोकन प्राप्त होगा जो आपको Tavily रिमोट MCP सर्वर पर सुरक्षित रूप से प्रमाणित अनुरोध करने देता है।

B. अन्य MCP क्लाइंट का उपयोग करना (उदाहरण: Cursor):

आप अपने MCP क्लाइंट को URL में अपनी Tavily API कुंजी शामिल किए बिना OAuth का उपयोग करने के लिए कॉन्फ़िगर कर सकते हैं। उदाहरण के लिए, अपने mcp.json में:

{
  "mcpServers": {
    "tavily-remote-mcp": {
      "command": "npx mcp-remote https://mcp.tavily.com/mcp",
      "env": {}
    }
  }
}

यदि आपको संग्रहीत OAuth क्रेडेंशियल्स को साफ़ करने और पुनः प्रमाणित करने की आवश्यकता है, तो चलाएँ:

rm -rf ~/.mcp-auth

नोट:

• OAuth प्रमाणीकरण वैकल्पिक है। आप ऊपर बताए अनुसार URL क्वेरी पैरामीटर (?tavilyApiKey=...) में अपनी Tavily API कुंजी शामिल करके या Authorization हेडर में सेट करके किसी भी समय API कुंजी प्रमाणीकरण का उपयोग कर सकते हैं।

OAuth के लिए कौन सी API कुंजी उपयोग की जाती है इसका चयन करना

सफल OAuth प्रमाणीकरण के बाद, आप इसे mcp_auth_default नाम देकर नियंत्रित कर सकते हैं कि कौन सी API कुंजी उपयोग की जाए:

• यदि आप अपने व्यक्तिगत खाते में mcp_auth_default नामक कुंजी सेट करते हैं, तो वह कुंजी प्रमाणीकरण प्रवाह के लिए उपयोग की जाएगी।
• यदि आप एक टीम का हिस्सा हैं जिसके पास mcp_auth_default नामक कुंजी है, तो वह कुंजी प्रमाणीकरण प्रवाह के लिए उपयोग की जाएगी।
• यदि आपके पास mcp_auth_default नामक दोनों एक व्यक्तिगत कुंजी और एक टीम कुंजी है, तो व्यक्तिगत कुंजी को प्राथमिकता दी जाएगी।
• यदि कोई mcp_auth_default कुंजी सेट नहीं है, तो आपके व्यक्तिगत खाते में default कुंजी का उपयोग किया जाएगा। यदि कोई default कुंजी सेट नहीं है, तो पहली उपलब्ध कुंजी का उपयोग किया जाएगा।

स्थानीय MCP

पूर्वापेक्षाएँ 🔧

शुरू करने से पहले, सुनिश्चित करें कि आपके पास है:

• Tavily API कुंजी
  • यदि आपके पास Tavily API कुंजी नहीं है, तो आप यहाँ एक मुफ़्त खाते के लिए साइन अप कर सकते हैं
• Claude Desktop या Cursor
• Node.js (v20 या उच्चतर)
  • आप चलाकर अपनी Node.js स्थापना सत्यापित कर सकते हैं:
    • node --version
• Git स्थापित (केवल तभी आवश्यक है जब Git स्थापना विधि का उपयोग कर रहे हों)
  • macOS पर: brew install git
  • Linux पर:
    • Debian/Ubuntu: sudo apt install git
    • RedHat/CentOS: sudo yum install git
  • Windows पर: Git for Windows डाउनलोड करें

NPX के साथ चलाना

npx -y tavily-mcp@latest 

डिफ़ॉल्ट पैरामीटर कॉन्फ़िगरेशन ⚙️

आप DEFAULT_PARAMETERS पर्यावरण चर का उपयोग करके tavily-search उपकरण के लिए डिफ़ॉल्ट पैरामीटर मान सेट कर सकते हैं। यह आपको प्रत्येक अनुरोध में इन पैरामीटरों को निर्दिष्ट किए बिना डिफ़ॉल्ट खोज व्यवहार कॉन्फ़िगर करने की अनुमति देता है।

उदाहरण कॉन्फ़िगरेशन

export DEFAULT_PARAMETERS='{"include_images": true}'

क्लाइंट से उदाहरण उपयोग

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here",
        "DEFAULT_PARAMETERS": "{\"include_images\": true, \"max_results\": 15, \"search_depth\": \"advanced\"}"
      }
    }
  }
}

अंतिम उपयोगकर्ता की पहचान करना (वैकल्पिक)

आप वैकल्पिक रूप से TAVILY_HUMAN_ID पर्यावरण चर सेट करके उस अंतिम उपयोगकर्ता की पहचान कर सकते हैं जिसकी ओर से अनुरोध किए जा रहे हैं। सेट होने पर, Tavily MCP इसे प्रत्येक API कॉल पर X-Human-Id हेडर के रूप में अग्रेषित करता है, जिससे प्रति-उपयोगकर्ता विश्लेषण सक्षम होता है।

यह पूरी तरह से वैकल्पिक है — इसे अनसेट छोड़ दें और व्यवहार अपरिवर्तित रहता है।

{
  "mcpServers": {
    "tavily-mcp": {
      "command": "npx",
      "args": ["-y", "tavily-mcp@latest"],
      "env": {
        "TAVILY_API_KEY": "your-api-key-here",
        "TAVILY_HUMAN_ID": "your-user-id"
      }
    }
  }
}

गोपनीयता नोट: Tavily भंडारण से पहले human_id को सर्वर-साइड (SHA-256) हैश करता है, इसलिए कच्चा मान कभी संग्रहीत नहीं किया जाता है। फिर भी, जब संभव हो तो कच्चे PII जैसे ईमेल पर अपारदर्शी पहचानकर्ताओं (जैसे, एक आंतरिक उपयोगकर्ता ID) को प्राथमिकता दें।

आभार ✨

• MCP विनिर्देश के लिए Model Context Protocol
• Claude Desktop के लिए Anthropic