IP2Location.io MCP Server

आधिकारिक

IP2Location.io API एकीकरण, किसी IP पते के लिए भू-स्थान जानकारी प्राप्त करने हेतु।

GitHub
13

दस्तावेज़

IP2Location.io MCP सर्वर

यह IP2Location.io API के लिए एक सरल मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर कार्यान्वयन है। यह किसी भी दिए गए IPv4 या IPv6 पते के लिए विस्तृत भौगोलिक स्थान जानकारी लौटाएगा।

mcp-ip2location-io MCP server

Trust Score

विशेषताएँ

  • व्यापक भौगोलिक स्थान डेटा: देश, क्षेत्र, शहर, अक्षांश, देशांतर, ज़िप कोड, समय क्षेत्र और अधिक सहित जानकारी की एक विस्तृत श्रृंखला प्राप्त करता है।
  • नेटवर्क विवरण: ASN, ISP, डोमेन और नेटवर्क गति जैसे नेटवर्क-संबंधित डेटा प्रदान करता है।
  • सुरक्षा अंतर्दृष्टि: प्रॉक्सी प्रकार और प्रदाता सहित प्रॉक्सी जानकारी का पता लगाता है।
  • सरल एकीकरण: एक FastMCP उपकरण के रूप में निर्मित, जो संगत प्रणालियों में आसान एकीकरण की अनुमति देता है।
  • अतुल्यकालिक: गैर-अवरोधक अतुल्यकालिक API अनुरोधों के लिए httpx का उपयोग करता है।

आवश्यकता

यह MCP सर्वर बिना API कुंजी के प्रश्नों का समर्थन करता है, जिसकी सीमा प्रति दिन 1,000 प्रश्न हैं। आप एक मुफ़्त API कुंजी के लिए साइन अप भी कर सकते हैं और प्रति माह 50,000 प्रश्नों तक का आनंद ले सकते हैं।

यदि आप क्लाउड-होस्टेड MCP सर्वर का उपयोग करते हैं, तो आपको केवल Claude Desktop और npx की आवश्यकता है, क्योंकि सर्वर दूरस्थ रूप से होस्ट किया गया है। यदि आप मूल MCP सर्वर को स्थानीय रूप से चलाना चाहते हैं, तो स्थानीय सेटअप uv का उपयोग करता है, जिसे गाइड का पालन करके स्थापित किया जा सकता है।

सेटअप

आप इस MCP सर्वर का उपयोग Claude Desktop में निम्नलिखित में से किसी भी तरीके से कर सकते हैं:

  • क्लाउड-होस्टेड MCP सर्वर: यदि आप सीधे होस्ट किए गए IP2Location.io MCP सर्वर से कनेक्ट करना चाहते हैं तो अनुशंसित।
  • स्थानीय MCP सर्वर: यदि आप अपनी मशीन पर मूल MCP सर्वर डाउनलोड और चलाना चाहते हैं तो इसका उपयोग करें।

विकल्प 1: क्लाउड-होस्टेड MCP सर्वर

Claude Desktop के साथ क्लाउड-होस्टेड IP2Location.io MCP सर्वर का उपयोग करने के लिए नीचे दिए गए चरणों का पालन करें:

  1. सुनिश्चित करें कि आपने Claude Desktop स्थापित कर लिया है। यदि आपने इसे अभी तक स्थापित नहीं किया है, तो Windows और macOS के लिए इसे यहाँ से डाउनलोड करें, या Linux उपयोगकर्ताओं के लिए इस गाइड का पालन करें।
  2. अपनी पसंद के संपादक में claude_desktop_config.json फ़ाइल खोलें। यदि आपके पास अभी तक एक नहीं है, तो एक बनाने के लिए इस गाइड का पालन करें।
  3. अपने claude_desktop_config.json में निम्नलिखित जोड़ें:
{
  "mcpServers": {
    "ip2location": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ip2location.io/",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}
  1. YOUR_API_KEY को अपनी वास्तविक IP2Location.io API कुंजी से बदलें। अपनी API कुंजी प्राप्त करने के लिए, अपने डैशबोर्ड में लॉग इन करें।
  2. परिवर्तनों को सहेजने के बाद Claude Desktop को पुनरारंभ करें, और आपको MCP सर्वर Connectors मेनू में दिखाई देना चाहिए।

विकल्प 2: स्थानीय MCP सर्वर

यदि आप Claude Desktop के साथ स्थानीय रूप से मूल MCP सर्वर चलाना चाहते हैं तो नीचे दिए गए चरणों का पालन करें:

  1. uv पैकेज मैनेजर सेट अप करें। आप ऐसा करने के लिए गाइड का संदर्भ ले सकते हैं।
  2. सुनिश्चित करें कि आपने Claude Desktop स्थापित कर लिया है। यदि आपने इसे अभी तक स्थापित नहीं किया है, तो Windows और macOS के लिए इसे यहाँ से डाउनलोड करें, या Linux उपयोगकर्ताओं के लिए इस गाइड का पालन करें।
  3. अपनी पसंद के संपादक में claude_desktop_config.json फ़ाइल खोलें। यदि आपके पास अभी तक एक नहीं है, तो एक बनाने के लिए इस गाइड का पालन करें।
  4. अपने claude_desktop_config.json में निम्नलिखित जोड़ें:
{
  "mcpServers": {
    "ip2locationio": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}
  1. अपनी API कुंजी प्राप्त करने के लिए, अपने डैशबोर्ड में लॉग इन करें। ऊपर दिए गए उदाहरण में <YOUR API key HERE> को अपनी वास्तविक API कुंजी से बदलें।
  2. परिवर्तनों को सहेजने के बाद Claude Desktop को पुनरारंभ करें, और आपको यह Connectors मेनू में दिखाई देना चाहिए।

उपयोग

बस Claude Desktop में एक चैट में IP के बारे में अपना प्रश्न दर्ज करें। कुछ उदाहरण प्रश्न होंगे:

  • (IP) का स्थान कहाँ है?
  • (IP) कहाँ स्थित है?
  • (IP) का निर्देशांक क्या है?

उदाहरण के लिए, IP 8.8.8.8 का परिणाम नीचे दिया गया है:

The output of the IP 8.8.8.8

Claude Desktop में, मॉडल IP2Location.io MCP सर्वर द्वारा लौटाए गए परिणाम के आधार पर स्वचालित रूप से आउटपुट उत्पन्न करेगा।

आप कई IP पतों के लिए क्वेरी करने हेतु IP2Location.io बल्क IP जियोलोकेशन API का उपयोग भी कर सकते हैं। बस प्रत्येक IP पते के बीच में स्पेस के साथ सभी IP पते इनपुट करें। उदाहरण के लिए 8.8.8.8 8.8.6.6।

[!NOTE]
IP2Location.io बल्क IP जियोलोकेशन API को काम करने के लिए एक सशुल्क योजना की आवश्यकता होती है।

पर्यावरण चर

IP2LOCATION_API_KEY

IP2Location.io API कुंजी, जो आपको प्रति माह 50,000 तक क्वेरी करने और IP पते के अधिक विवरण प्राप्त करने की अनुमति देती है। आप एक मुफ़्त API कुंजी के लिए साइन अप कर सकते हैं, या अधिक लाभों का आनंद लेने के लिए किसी योजना की सदस्यता ले सकते हैं।

उपकरण

get_geolocation

विवरण दिए गए IP पते या IP पतों के बैच के लिए भौगोलिक स्थान प्राप्त करें। यह उपयोगकर्ताओं को किसी भी IPv4 या IPv6 पते के लिए देश, क्षेत्र, शहर, अक्षांश, देशांतर, ज़िप कोड, समय क्षेत्र, ASN और प्रॉक्सी जानकारी जैसी विस्तृत जानकारी प्राप्त करने में मदद करता है। जब कई IP का पता चलता है तो यह कुशल प्रसंस्करण के लिए स्वचालित रूप से अनुरोधों को IP2Location.io बल्क API पर रूट करता है।

तर्क

  • ip (str): विश्लेषण करने के लिए IP पता (IPv4 या IPv6)। आप अल्पविराम, रिक्त स्थान या नई पंक्तियों द्वारा अलग किए गए एकल स्ट्रिंग के रूप में पास करके एक साथ कई IP क्वेरी कर सकते हैं (जैसे, "1.1.1.1, 2.2.2.2")।

रिटर्न भौगोलिक स्थान डेटा वाली एक JSON स्ट्रिंग। यदि कई IP क्वेरी किए जाते हैं, तो यह एक JSON ऑब्जेक्ट लौटाता है जहाँ प्रत्येक कुंजी एक IP पता है जो उसके संबंधित डेटा से मैप किया गया है। आपकी API योजना के आधार पर परिणाम में निम्नलिखित फ़ील्ड शामिल हो सकते हैं:

  • स्थान और भूगोल: देश, क्षेत्र, जिला, शहर, ज़िप कोड, अक्षांश और देशांतर, समय क्षेत्र।
  • नेटवर्क और कनेक्टिविटी: ASN (ऑटोनॉमस सिस्टम नंबर), ISP (इंटरनेट सेवा प्रदाता), डोमेन, नेट स्पीड, IDD कोड, क्षेत्र कोड, पता प्रकार, उपयोग प्रकार।
  • मोबाइल जानकारी: MNC (मोबाइल नेटवर्क कोड), MCC (मोबाइल कंट्री कोड), मोबाइल ब्रांड।
  • मुद्रा और भाषा: मुद्रा कोड, मुद्रा नाम, मुद्रा प्रतीक, भाषा कोड, भाषा नाम।
  • प्रॉक्सी और सुरक्षा: प्रॉक्सी प्रकार, अंतिम बार देखा गया, खतरा स्तर/प्रकार, प्रॉक्सी प्रदाता, धोखाधड़ी स्कोर।
  • अन्य: IAB श्रेणी, मौसम, ऊंचाई, जनसंख्या, और अधिक।

यदि एकल IP अनुरोध विफल रहता है या IP अमान्य है, तो उपकरण एक स्ट्रिंग के रूप में एक त्रुटि संदेश लौटाता है। बल्क अनुरोधों के लिए, कोई भी व्यक्तिगत विफल IP पूरे बैच को विफल किए बिना उस विशिष्ट IP पते पर मैप की गई एक त्रुटि ऑब्जेक्ट लौटाएगा।

लाइसेंस

LICENSE फ़ाइल देखें।