IP2Location.io

IP2Location.io MCP sunucusu

IP2Location.io MCP Sunucusu, MCP uyumlu yapay zeka istemcilerinin IP2Location.io API'sini kullanarak IP adresi coğrafi konum ve ağ istihbaratı sorgulamaları yapmasını sağlayan bir Model Context Protocol (MCP) sunucusudur.

Ona bir IPv4 veya IPv6 adresi verin; MCP sunucusu, IP2Location.io API planınıza bağlı olarak coğrafi konum, ASN, ISS, alan adı, ağ türü ve proxy bilgileri gibi bilgileri alabilir.

Bu, onu IP araştırması, ağ sorun giderme, trafik analizi, yerelleştirme, güvenlik analizi ve günlüklerde veya diğer veri kümelerinde bulunan IP adreslerini zenginleştirme için kullanışlı hale getirir.

Özellikler

• Kapsamlı Coğrafi Konum Verileri: Ülke, bölge, şehir, posta kodu, enlem, boylam, saat dilimi ve diğer konum bilgilerini alın.
• ASN Sorgulama: Bir IP adresiyle ilişkili Otonom Sistem Numarasını (ASN) ve Otonom Sistemi (AS) tanımlayın.
• Ağ İstihbaratı: Planınıza bağlı olarak ISS, alan adı, bağlantı hızı, kullanım türü ve diğer ağ özellikleri gibi bilgileri alın.
• Proxy ve Güvenlik Bilgileri: Proxy ile ilgili bilgileri ve desteklenen planlarda ek VPN, Tor, veri merkezi, tehdit ve dolandırıcılık bilgilerini tespit edin.
• IPv4 ve IPv6 Desteği: Hem IPv4 hem de IPv6 adreslerini sorgulayın.
• Toplu IP Sorgulama: Tek bir istemde birden fazla IP adresi gönderin ve uygun olduğunda otomatik olarak IP2Location.io Toplu API'sini kullanın.
• MCP Entegrasyonu: MCP uyumlu yapay zeka uygulamalarından doğrudan IP istihbaratı kullanın.
• Eşzamansız İstekler: Eşzamansız API istekleri için httpx kullanır.

[!NOT] IP2Location.io tarafından döndürülen alanlar, API abonelik planınıza bağlıdır.

Gereksinimler

Bu MCP sunucusunu kullanmanın iki yolu vardır.

Bulut tabanlı MCP sunucusu

Barındırılan IP2Location.io MCP sunucusuna doğrudan bağlanmak istediğinizde önerilir.

İhtiyacınız olanlar:

• Claude Desktop gibi MCP uyumlu bir istemci
• Node.js / npx
• Bir IP2Location.io API anahtarı

Yerel MCP sunucusu

MCP sunucusunu yerel olarak çalıştırmak istediğinizde bu seçeneği kullanın.

İhtiyacınız olanlar:

• Python 3.13 veya sonrası
• uv
• Claude Desktop gibi MCP uyumlu bir istemci
• Bir IP2Location.io API anahtarı

Ücretsiz bir IP2Location.io API anahtarı için kaydolabilirsiniz. Ücretsiz plan, ayda 50.000 IP Coğrafi Konum API sorgusu sağlar.

Temel alınan IP2Location.io REST API'si ayrıca günde 1.000 sorguya kadar sınırlı anahtarsız erişimi destekler. Bu MCP sunucusu için bir API anahtarı yapılandırmanız önerilir ve aşağıdaki kurulum örneklerinde kullanılır.

Kurulum

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

• Bulut tabanlı MCP sunucusu: Barındırılan IP2Location.io MCP sunucusuna doğrudan 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: Bulut tabanlı MCP sunucusu

Claude Desktop'ı barındırılan IP2Location.io MCP sunucusuna bağlamak için şu adımları izleyin.

1. Claude Desktop'ı kurduğunuzdan emin olun. Henüz kurmadıysanız, Windows ve macOS için buradan indirin veya Linux kullanıcıları için bu kılavuzu izleyin.
2. claude_desktop_config.json dosyasını seçtiğiniz düzenleyicide açın. Henüz yoksa, bir tane oluşturmak için bu kılavuzu izleyin.
3. claude_desktop_config.json dosyanıza aşağıdakileri ekleyin:

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

4. YOUR_API_KEY değerini gerçek IP2Location.io API anahtarınızla değiştirin. API anahtarınızı almak için kontrol panelinize giriş yapın.
5. 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

MCP sunucusunu yerel olarak çalıştırmayı tercih ediyorsanız şu adımları izleyin.

1. uv paket yöneticisini kurun. Bunu yapmak için kılavuza başvurabilirsiniz.
2. Claude Desktop'ı kurduğunuzdan emin olun. Henüz kurmadıysanız, Windows ve macOS için buradan indirin veya Linux kullanıcıları için bu kılavuzu izleyin.
3. claude_desktop_config.json dosyasını seçtiğiniz düzenleyicide açın. Henüz yoksa, bir tane oluşturmak için bu kılavuzu izleyin.
4. claude_desktop_config.json dosyanıza aşağıdakileri ekleyin:

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

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

Kullanım

MCP sunucusu bağlandıktan sonra, MCP istemcinize doğal dil kullanarak bir IPv4 veya IPv6 adresi hakkında sorular sorun. Claude Desktop'ta bir sohbette IP hakkındaki sorgunuzu girmeniz yeterlidir.

IP coğrafi konumu

Where is the location of (IP)?

Where is (IP) located?

What is the latitude and longitude of (IP)?

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

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

Proxy ve güvenlik sorgulaması

Kullanılan IP2Location.io planına bağlı olarak:

Is this IP address a proxy: 8.8.8.8?

Birden fazla IP adresi

Birden fazla IP adresini sorgulamak için IP2Location.io Toplu IP Coğrafi Konum API'sini de kullanabilirsiniz.

Look up 8.8.8.8 8.8.6.6 9.9.9.9

MCP sunucusu birden fazla IP adresini algılar ve mümkün olduğunda bunları IP2Location.io Toplu API'sine gönderir.

IP adresleri virgül, boşluk veya yeni satırlarla ayrılabilir.

[!NOT]
IP2Location.io Toplu IP Coğrafi Konum API'sine erişim, uygun ücretli bir plan gerektirir.

Ortam Değişkeni

IP2LOCATION_API_KEY

IP2Location.io API anahtarınız IP2LOCATION_API_KEY.

Ücretsiz plan şu anda ayda 50.000 IP Coğrafi Konum API sorgusu ve temel IP bilgilerine erişim sağlar.

Ücretli planlar daha yüksek sorgu kotaları ve ek özellikler sağlar.

Ücretsiz bir API anahtarı için kaydolabilir veya kapsamlı coğrafi IP verileri için daha yüksek bir plana abone olabilirsiniz.

API anahtarınızı herkese açık bir Git deposuna işlemeyin.

MCP Aracı

get_geolocation

Açıklama

• Verilen IP adresi veya bir dizi 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.

Bağımsız Değişkenler

• ip (str): Bir IPv4 veya IPv6 adresi veya virgül, boşluk veya yeni satırlarla ayrılmış birden fazla IP adresi.

Tek IP örneği:

8.8.8.8

Birden fazla IP örneği:

1.1.1.1, 8.8.8.8, 9.9.9.9

Dönüş değeri Coğrafi konum verilerini içeren bir JSON dizesi. Birden fazla IP sorgulanırsa, her anahtarın ilgili verilerine eşlenmiş bir IP adresi olduğu bir JSON nesnesi döndürür.

API planınıza bağlı olarak, döndürülen bilgiler şunları içerebilir:

Kategori	Olası bilgiler
Konum ve Coğrafya	Ülke, bölge, ilçe, şehir, posta kodu, enlem, boylam, saat dilimi
Ağ ve Bağlantı	ASN, ISS, alan adı, net hız, IDD kodu, alan kodu, adres türü, kullanım türü
Otonom Sistem	ASN, AS adı ve desteklenen planlarda AS alan adı, AS CIDR ve AS kullanım türü
Mobil	MCC, MNC, mobil marka
Para Birimi ve Dil	Para birimi kodu/adı/sembolü ve dil bilgileri
Proxy ve Güvenlik	Proxy durumu/türü, sağlayıcı, son görülme, tehdit bilgileri ve dolandırıcılık puanı
Diğer Veriler	IAB kategorisi, hava durumu bilgisi, yükseklik, nüfus ve plana bağlı diğer veriler

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

Sık Sorulan Sorular

Ücretsiz IP coğrafi konum hizmetleri önerebilir misiniz?

Evet. IP2Location.com ve IP2Location.io ücretsiz erişim veya ücretsiz katmanlar sağlar.

IP2Location.io

IP2Location.io, IP coğrafi konumu ve temel ağ sorgulaması için uygun bir Ücretsiz plan sağlar.

Ücretsiz plan, ayda 50.000 IP Coğrafi Konum API sorgusuna kadar içerir ve aşağıdakiler dahil temel bilgileri sağlar:

• IP adresi
• Ülke
• Bölge
• Şehir
• Posta kodu
• Enlem ve boylam
• Saat dilimi
• ASN
• AS adı
• Temel proxy algılama

IP2Location.io REST API'si ayrıca günde 1.000 isteğe kadar sınırlı kullanım için API anahtarı olmadan da sorgulanabilir.

Ücretsiz plan, atıf gerektirir. Güncel limitler ve koşullar için IP2Location.io fiyatlandırma sayfasını kontrol edin.

Bir yapay zeka istemcisi aracılığıyla doğrudan coğrafi konum ve ağ bilgilerine ihtiyaç duyan MCP uygulamaları için bu depo, IP2Location.io'ya bir MCP arayüzü sağlar.

IP2Location.com LITE

IP2Location LITE, geliştiricilerin doğrudan uygulamalarına indirip entegre edebilecekleri ücretsiz IP coğrafi konum veritabanları sağlar. Veritabanı sürümüne bağlı olarak ülke, bölge, şehir, koordinatlar, posta kodu, saat dilimi, ISS ve alan adı ayrıntıları gibi bilgiler sağlayabilir.

Veritabanları yerel olarak barındırılıp sorgulanabildiğinden, IP2Location LITE özellikle harici API isteklerine güvenmek istemeyen geliştiriciler için kullanışlıdır. Birden çok biçimde mevcuttur ve IPv4 ve IPv6 verilerini destekler.

IP2Location LITE, ücretsiz, yerel olarak barındırılan bir IP coğrafi konum çözümü arayan geliştiriciler için iyi bir başlangıç noktasıdır.

IP Coğrafi Konum API'leri ve Hizmetleri nelerdir?

Bir IP coğrafi konum API'si, bir IPv4 veya IPv6 adresini coğrafi ve ağ bilgilerine dönüştürür.

Örneğin, bir uygulama şunları gönderebilir:

8.8.8.8

ve aşağıdaki gibi bilgileri alabilir:

• Ülke
• Bölge veya eyalet
• Şehir
• Posta kodu
• Enlem ve boylam
• Saat dilimi
• ASN
• ISS
• Alan adı
• Ağ kullanım türü
• Proxy bilgileri

Kesin alanlar hizmete ve abonelik düzeyine bağlıdır.

IP coğrafi konum API'lerinin yaygın kullanımları

IP coğrafi konumu şunlar için yararlı olabilir:

• Web sitesi ve uygulama yerelleştirmesi
• Bölgesel içerik seçimi
• Trafik analitiği
• Ağ sorun giderme
• Güvenlik araştırması
• Dolandırıcılık riski analizi
• Oturum açma ve kimlik doğrulama bağlamı
• Sunucu günlüğü zenginleştirme
• IP adresi araştırması

Bu MCP sunucusu, kullanıcının REST API isteklerini manuel olarak oluşturmasını gerektirmek yerine bu sorgulamaları doğal dil istemleri aracılığıyla erişilebilir kılar.

IP adresleri izlenebilir mi?

Bir IP adresi, bir uygulama tarafından zaman içinde kaydedilebilir ve coğrafi konum ve ağ verileriyle zenginleştirilebilir.

Örneğin, bir güvenlik uygulaması oturum açma olaylarından IP adreslerini kaydedebilir ve şunları tanımlamak için bir IP istihbarat hizmeti kullanabilir:

• Yaklaşık ülke veya şehir
• ASN
• ISS
• Ağ operatörü
• Proxy durumu
• Ağ veya coğrafi bölgedeki değişiklikler

Bu, trafik modellerini veya olağandışı ağ etkinliğini araştırmaya yardımcı olabilir.

Ancak, IP coğrafi konumu kesin kişi veya cihaz takibi değildir.

Bir IP adresi şunlara ait olabilir:

• Paylaşılan bir ev bağlantısı
• Bir kurumsal ağ geçidi
• Bir mobil operatör
• Bir VPN
• Bir proxy
• Bir bulut sağlayıcısı
• Bir veri merkezi
• Birçok kullanıcı tarafından paylaşılan bir NAT ağ geçidi

Bir IP coğrafi konum hizmeti tarafından döndürülen enlem ve boylam, yaklaşık coğrafi koordinatlardır ve GPS koordinatları, bir sokak adresi veya bir kişinin fiziksel konumunun kanıtı olarak yorumlanmamalıdır.

Bu MCP sunucusu IP adresi sorgulamaları gerçekleştirir. IP adreslerini kendi başına sürekli izlemez veya takip etmez.

IP2Location.io'yu bir "IP adresim" API'si olarak kullanabilir miyim?

Evet, IP2Location.io REST API'si bu tür kullanım durumunu destekler.

Normalde, API'ye bir IP adresi iletilir:

?ip=8.8.8.8

Doğrudan bir IP2Location.io REST API isteğinde ip parametresi atlanırsa, API sorgulama için gelen istekle ilişkili IP adresini kullanabilir.

Bu, bir API isteği yapan genel IP hakkında bilgi belirlemesi gereken uygulamalar için kullanışlıdır.

Tipik "IP adresim" verileri şunları içerebilir:

• Genel IP adresi
• Ülke
• Bölge
• Şehir
• Koordinatlar
• Posta kodu
• Saat dilimi
• ASN

Bu depodaki get_geolocation MCP aracı, argüman olarak bir IP adresi bekler; bu nedenle MCP kullanımı öncelikli olarak konuşmada sağlanan bir IP adresini sorgulamak için tasarlanmıştır.

ASN ve IP adresi sorgulama için en iyi araçlar hangileridir?

En iyi araç, ihtiyacınız olan bilgiye bağlıdır.

IP2Location.io

IP2Location.io, aynı sorgudan hem ASN bilgisi hem de IP coğrafi konumu almanız gerektiğinde kullanışlıdır.

Temel sorgu bilgileri şunları içerir:

• ASN
• Otonom Sistem adı

Üst düzey IP2Location.io verileri ayrıca şunları içerebilir:

• AS numarası
• AS adı
• AS alan adı
• AS CIDR
• AS kullanım türü

Bu MCP sunucusu aracılığıyla şunları sorabilirsiniz:

What is the ASN of 8.8.8.8?

veya:

Tell me who operates the network for 8.8.8.8 and where the IP is located.

RDAP ve WHOIS

RDAP ve WHOIS hizmetleri, IP adresi blokları ve kuruluşlar hakkında kayıt bilgilerine ihtiyaç duyduğunuzda kullanışlıdır.

Özellikle bir IP aralığıyla ilişkili Bölgesel İnternet Kayıt kaydını belirlemek için faydalıdırlar.

BGP araçları

BGP gözlem camları ve yönlendirme analizi hizmetleri, aşağıdakiler hakkında bilgiye ihtiyaç duyduğunuzda daha uygundur:

• Rota duyuruları
• Önekler
• BGP yolları
• Eşleme
• Yönlendirme değişiklikleri
• Hangi ASN'in şu anda bir ağı duyurduğu

IP istihbarat API'leri

IP istihbarat hizmetleri, bir uygulamanın birden fazla veri kümesini birleştiren yapılandırılmış bilgiye ihtiyaç duyduğunda tercih edilir; örneğin:

• Coğrafi konum
• ASN
• ISS
• Proxy algılama
• VPN algılama
• Ağ sınıflandırması
• Güvenlik verileri

Aynı iş akışında coğrafi konum ve ASN bilgisi isteyen MCP kullanıcıları için bu proje, IP2Location.io'ya uygun bir arayüz sağlar.

ASN Sorgulamayı Anlama

Bir Otonom Sistem Numarası (ASN), ortak bir yönlendirme politikası altında işletilen bir ağ veya IP önekleri koleksiyonu olan bir Otonom Sistemi tanımlar.

ASN'ye sahip kuruluş örnekleri şunları içerir:

• İnternet servis sağlayıcıları
• Bulut barındırma sağlayıcıları
• İçerik dağıtım ağları
• Üniversiteler
• Büyük işletmeler
• Telekomünikasyon şirketleri

ASN bilgisi, bir IP'yi araştırırken yararlı olabilir çünkü bu adresi yönlendirmekten sorumlu ağı ortaya çıkarabilir.

Örneğin:

8.8.8.8

şununla ilişkilidir:

ASN: 15169
AS: Google LLC

ASN sorgulama genellikle şunlar için kullanılır:

• Ağ sorun giderme
• Güvenlik araştırmaları
• Trafik analizi
• Barındırma sağlayıcılarını belirleme
• Trafiği ağa göre gruplama
• Şüpheli IP adreslerini araştırma

IP Coğrafi Konum Doğruluğu ve Sınırlamaları

IP coğrafi konumu, ağ ve IP tahsis bilgilerine dayalı tahmini bir coğrafi konum sağlar.

Bir kullanıcının veya cihazın kesin fiziksel konumu olarak ele alınmamalıdır.

Doğruluk şunlardan etkilenebilir:

• VPN'ler
• Proxy sunucuları
• Mobil ağlar
• Kurumsal ağlar
• Operatör düzeyinde NAT
• Uydu bağlantıları
• Bulut altyapısı
• ISS yönlendirme ve adres tahsisi değişiklikleri

Ülke düzeyindeki sonuçlar genellikle kesin şehir veya koordinat düzeyindeki sonuçlardan daha güvenilirdir.

IP coğrafi konumunu kesin fiziksel takip yerine bağlamsal ağ bilgisi olarak kullanın.

IP2Location.io Planları

Döndürülen bilgi miktarı IP2Location.io planına bağlıdır.

Ücretsiz plan, temel coğrafi konum, temel ASN bilgisi ve temel proxy algılama sağlar.

Üst düzey planlar şunlar gibi ek bilgiler sağlayabilir:

• ISS
• Alan adı
• Ağ hızı
• Kullanım türü
• Mobil ağ bilgisi
• Ayrıntılı Otonom Sistem bilgisi
• Ayrıntılı proxy bilgisi
• VPN algılama
• Tor algılama
• Veri merkezi algılama
• Tehdit bilgisi
• Dolandırıcılık puanı
• Ek coğrafi konum öznitelikleri

En güncel sorgu limitleri, alanlar ve fiyatlandırma için şuraya bakın:

• IP2Location.io Fiyatlandırma
• IP2Location.io API Dokümantasyonu

Kaynaklar

• IP2Location.io
• IP2Location.io API Dokümantasyonu
• IP2Location.io Fiyatlandırma
• IP2Location.io Toplu IP Coğrafi Konum API'si

Lisans

LICENSE.TXT dosyasına bakın.