IP2Location.io MCP Server

resmi

IP2Location.io API entegrasyonu, bir IP adresinin coğrafi konum bilgilerini almak için kullanılır.

Dokümantasyon

IP2Location.io MCP sunucusu

Bu, IP2Location.io API'si için basit bir Model Bağlam Protokolü (MCP) sunucu uygulamasıdır. Verilen herhangi bir IPv4 veya IPv6 adresi için ayrıntılı coğrafi konum bilgisi döndürür.

Özellikler

Kapsamlı Coğrafi Konum Verisi: Ülke, bölge, şehir, enlem, boylam, posta kodu, saat dilimi ve daha fazlası dahil olmak üzere geniş bir bilgi yelpazesi alır.
Ağ Detayları: ASN, ISS, alan adı ve ağ hızı gibi ağ ile ilgili veriler sağlar.
Güvenlik İçgörüleri: Proxy türü ve sağlayıcısı dahil olmak üzere proxy bilgilerini tespit eder.
Basit Entegrasyon: Uyumlu sistemlere kolay entegrasyon sağlayan bir FastMCP aracı olarak oluşturulmuştur.
Asenkron: Engellemesiz asenkron API istekleri için httpx kullanır.

Gereksinim

Bu MCP sunucusu, API anahtarı olmadan günde 1.000 sorgu sınırıyla sorguları destekler. Ayrıca ücretsiz bir API anahtarı için kaydolabilir ve ayda 50.000'e kadar sorgunun keyfini çıkarabilirsiniz.

Bulutta barındırılan MCP sunucusunu kullanıyorsanız, sunucu uzaktan barındırıldığı için yalnızca Claude Desktop ve npx'a ihtiyacınız vardır. Orijinal MCP sunucusunu yerel olarak çalıştırmak istiyorsanız, yerel kurulum kılavuzu izleyerek kurulabilen uv kullanır.

Kurulum

Bu MCP sunucusunu Claude Desktop'ta aşağıdaki yollardan biriyle kullanabilirsiniz:

Bulutta barındırılan MCP sunucusu: Doğrudan barındırılan IP2Location.io MCP sunucusuna bağlanmak istiyorsanız önerilir.
Yerel MCP sunucusu: Orijinal MCP sunucusunu kendi makinenize indirip çalıştırmak istiyorsanız bunu kullanın.

Seçenek 1: Bulutta barındırılan MCP sunucusu

Claude Desktop ile bulutta barındırılan IP2Location.io MCP sunucusunu kullanmak için aşağıdaki adımları izleyin:

Claude Desktop'ın yüklü olduğundan emin olun. Henüz yüklemediyseniz, Windows ve macOS için buradan indirin veya Linux kullanıcıları için bu kılavuzu izleyin.
claude_desktop_config.json dosyasını tercih ettiğiniz bir düzenleyicide açın. Henüz bir tane yoksa, bir tane oluşturmak için bu kılavuzu izleyin.
claude_desktop_config.json dosyanıza aşağıdakini ekleyin:

{
  "mcpServers": {
    "ip2location": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ip2location.io/",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}

YOUR_API_KEY kısmını gerçek IP2Location.io API anahtarınızla değiştirin. API anahtarınızı almak için kontrol panelinize giriş yapın.
Değişiklikleri kaydettikten sonra Claude Desktop'ı yeniden başlatın; MCP sunucusunun Connectors menüsünde göründüğünü görmelisiniz.

Seçenek 2: Yerel MCP sunucusu

Orijinal MCP sunucusunu Claude Desktop ile yerel olarak çalıştırmak istiyorsanız aşağıdaki adımları izleyin:

uv paket yöneticisini kurun. Bunu yapmak için kılavuza başvurabilirsiniz.
Claude Desktop'ın yüklü olduğundan emin olun. Henüz yüklemediyseniz, Windows ve macOS için buradan indirin veya Linux kullanıcıları için bu kılavuzu izleyin.
claude_desktop_config.json dosyasını tercih ettiğiniz bir düzenleyicide açın. Henüz bir tane yoksa, bir tane oluşturmak için bu kılavuzu izleyin.
claude_desktop_config.json dosyanıza aşağıdakini ekleyin:

{
  "mcpServers": {
    "ip2locationio": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}

API anahtarınızı almak için kontrol panelinize giriş yapın. Yukarıdaki örnekteki <YOUR API key HERE> kısmını gerçek API anahtarınızla değiştirin.
Değişiklikleri kaydettikten sonra Claude Desktop'ı yeniden başlatın; Connectors menüsünde göründüğünü görmelisiniz.

Kullanım

Claude Desktop'ta bir sohbete IP hakkında sorgunuzu girmeniz yeterlidir. Bazı örnek sorgular şunlardır:

(IP) adresinin konumu neresidir?
(IP) nerede bulunuyor?
(IP) adresinin koordinatı nedir?

Örneğin, aşağıda 8.8.8.8 IP adresinin sonucu verilmiştir:

The output of the IP 8.8.8.8

Claude Desktop'ta model, IP2Location.io MCP sunucusu tarafından döndürülen sonuca dayalı olarak çıktıyı otomatik olarak oluşturacaktır.

Birden fazla IP adresini sorgulamak için IP2Location.io Toplu IP Coğrafi Konum API'sini de kullanabilirsiniz. Tüm IP adreslerini aralarında boşluk olacak şekilde girmeniz yeterlidir. Örneğin 8.8.8.8 8.8.6.6.

[!NOT]
IP2Location.io Toplu IP Coğrafi Konum API'si, çalışması için ücretli bir plan gerektirir.

Ortam Değişkeni

IP2LOCATION_API_KEY

IP2Location.io API anahtarı, ayda 50.000'e kadar sorgulama ve IP adresinin daha fazla detayını almanızı sağlar. Ücretsiz bir API anahtarı için kaydolabilir veya daha fazla avantajdan yararlanmak için bir plana abone olabilirsiniz.

Araç

get_geolocation

Açıklama Verilen IP adresi veya bir grup IP adresi için coğrafi konumu getirir. Kullanıcıların herhangi bir IPv4 veya IPv6 adresi için ülke, bölge, şehir, enlem, boylam, posta kodu, saat dilimi, ASN ve proxy bilgileri gibi ayrıntılı bilgileri almasına yardımcı olur. Birden fazla IP algılandığında, verimli işleme için istekleri otomatik olarak IP2Location.io Toplu API'sine yönlendirir.

Argümanlar

ip (str): Analiz edilecek IP adresi (IPv4 veya IPv6). Virgül, boşluk veya yeni satırlarla ayrılmış tek bir dize olarak geçirerek birden fazla IP'yi aynı anda sorgulayabilirsiniz (örn., "1.1.1.1, 2.2.2.2").

Döndürür Coğrafi konum verilerini içeren bir JSON dizesi. Birden fazla IP sorgulanırsa, her anahtarın bir IP adresine karşılık gelen verilerine eşlendiği bir JSON nesnesi döndürür. API planınıza bağlı olarak sonuç aşağıdaki alanları içerebilir:

Konum ve Coğrafya: Ülke, bölge, ilçe, şehir, posta kodu, enlem ve boylam, saat dilimi.
Ağ ve Bağlantı: ASN (Otonom Sistem Numarası), ISS (İnternet Servis Sağlayıcısı), alan adı, ağ hızı, IDD kodu, alan kodu, adres türü, kullanım türü.
Mobil Bilgiler: MNC (Mobil Ağ Kodu), MCC (Mobil Ülke Kodu), Mobil Marka.
Para Birimi ve Dil: para birimi kodu, para birimi adı, para birimi sembolü, dil kodu, dil adı.
Proxy ve Güvenlik: proxy türü, son görülme, tehdit seviyesi/türü, proxy sağlayıcısı, dolandırıcılık puanı.
Diğerleri: IAB kategorisi, hava durumu, rakım, nüfus ve daha fazlası.

Tek bir IP isteği başarısız olursa veya IP geçersizse, araç bir hata mesajını dize olarak döndürür. Toplu istekler için, başarısız olan herhangi bir bireysel IP, tüm toplu işlemi başarısız kılmadan o belirli IP adresine eşlenmiş bir hata nesnesi döndürür.

Lisans

LİSANS dosyasına bakın.