IP2Location.io

Server MCP IP2Location.io

IP2Location.io MCP Server adalah server Model Context Protocol (MCP) yang memungkinkan klien AI yang kompatibel dengan MCP melakukan pencarian geolokasi alamat IP dan intelijen jaringan menggunakan API IP2Location.io.

Berikan alamat IPv4 atau IPv6, dan server MCP dapat mengambil informasi seperti lokasi geografis, ASN, ISP, domain, jenis jaringan, dan informasi proxy, bergantung pada paket API IP2Location.io Anda.

Server ini berguna untuk investigasi IP, pemecahan masalah jaringan, analisis lalu lintas, pelokalan, analisis keamanan, serta memperkaya alamat IP yang ditemukan dalam log atau kumpulan data lainnya.

Fitur

• Data Geolokasi Komprehensif: Ambil informasi negara, wilayah, kota, kode ZIP/kode pos, lintang, bujur, zona waktu, dan informasi lokasi lainnya.
• Pencarian ASN: Identifikasi Autonomous System Number (ASN) dan Autonomous System (AS) yang terkait dengan alamat IP.
• Intelijen Jaringan: Ambil informasi seperti ISP, domain, kecepatan koneksi, jenis penggunaan, dan atribut jaringan lainnya, bergantung pada paket Anda.
• Informasi Proxy dan Keamanan: Deteksi informasi terkait proxy dan, pada paket yang mendukung, informasi tambahan tentang VPN, Tor, pusat data, ancaman, dan penipuan.
• Dukungan IPv4 dan IPv6: Lakukan kueri untuk alamat IPv4 dan IPv6.
• Pencarian IP Massal: Kirim beberapa alamat IP dalam satu prompt dan gunakan IP2Location.io Bulk API secara otomatis jika tersedia.
• Integrasi MCP: Gunakan intelijen IP langsung dari aplikasi AI yang kompatibel dengan MCP.
• Permintaan Asinkron: Menggunakan httpx untuk permintaan API asinkron.

[!NOTE] Kolom yang dikembalikan oleh IP2Location.io bergantung pada paket langganan API Anda.

Persyaratan

Ada dua cara untuk menggunakan server MCP ini.

Server MCP yang dihosting di cloud

Direkomendasikan jika Anda ingin terhubung langsung ke server MCP IP2Location.io yang dihosting.

Anda dapat terhubung dengan salah satu dari dua cara berikut:

• Koneksi HTTP langsung: Klien MCP Anda mendukung server MCP jarak jauh (streamable HTTP). Tidak diperlukan perangkat lunak tambahan.
• Melalui npx: Klien MCP Anda hanya mendukung server lokal (stdio). Cara ini menggunakan paket mcp-remote sebagai jembatan ke server yang dihosting.

Anda memerlukan:

• Klien yang kompatibel dengan MCP, seperti Claude Desktop
• Kunci API IP2Location.io
• Node.js / npx (hanya untuk metode koneksi npx)

Server MCP lokal

Gunakan opsi ini jika Anda ingin menjalankan server MCP secara lokal.

Anda memerlukan:

• Python 3.13 atau yang lebih baru
• uv
• Klien yang kompatibel dengan MCP, seperti Claude Desktop
• Kunci API IP2Location.io

Anda dapat mendaftar untuk mendapatkan kunci API IP2Location.io gratis. Paket Free menyediakan hingga 50,000 kueri IP Geolocation API per bulan.

REST API IP2Location.io yang mendasarinya juga mendukung akses terbatas tanpa kunci hingga 1,000 kueri per hari. Untuk server MCP ini, konfigurasi kunci API direkomendasikan dan digunakan dalam contoh penyiapan di bawah.

Penyiapan

Anda dapat menggunakan server MCP ini di Claude Desktop dengan salah satu cara berikut:

• Server MCP yang dihosting di cloud: Direkomendasikan jika Anda ingin terhubung langsung ke server MCP IP2Location.io yang dihosting.
• Server MCP lokal: Gunakan opsi ini jika Anda ingin mengunduh dan menjalankan server MCP asli di komputer Anda sendiri.

Opsi 1: Server MCP yang dihosting di cloud

Ikuti langkah-langkah berikut untuk menghubungkan Claude Desktop ke server MCP IP2Location.io yang dihosting.

1. Pastikan Claude Desktop sudah terinstal. Jika belum, unduh dari sini untuk Windows dan macOS, atau ikuti panduan ini untuk pengguna Linux.
2. Buka file claude_desktop_config.json menggunakan editor pilihan Anda. Jika belum memilikinya, ikuti panduan ini untuk membuatnya.
3. Tambahkan salah satu konfigurasi di bawah, sesuai dengan cara Anda ingin terhubung.

Metode A: Koneksi HTTP langsung

Gunakan metode ini jika klien MCP Anda mendukung server jarak jauh melalui HTTP. Node.js atau npx tidak diperlukan.

{
  "mcpServers": {
    "ip2location": {
      "type": "http",
      "url": "https://mcp.ip2location.io/",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Jika klien Anda dikonfigurasi melalui baris perintah, seperti Claude Code, Anda dapat menambahkan server dengan:

claude mcp add --transport http ip2location https://mcp.ip2location.io/ --header "X-API-Key: YOUR_API_KEY"

Metode B: Koneksi melalui npx

Gunakan metode ini jika klien MCP Anda hanya mendukung server lokal (stdio). Paket mcp-remote berjalan secara lokal dan meneruskan permintaan ke server yang dihosting.

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

4. Ganti YOUR_API_KEY dengan kunci API IP2Location.io Anda. Untuk mendapatkan kunci API, masuk ke dasbor Anda.
5. Mulai ulang Claude Desktop setelah menyimpan perubahan. Server MCP akan muncul di menu Connectors.

Opsi 2: Server MCP lokal

Ikuti langkah-langkah berikut jika Anda lebih memilih menjalankan server MCP secara lokal.

1. Siapkan pengelola paket uv. Anda dapat merujuk ke panduan ini untuk melakukannya.
2. Pastikan Claude Desktop sudah terinstal. Jika belum, unduh dari sini untuk Windows dan macOS, atau ikuti panduan ini untuk pengguna Linux.
3. Buka file claude_desktop_config.json menggunakan editor pilihan Anda. Jika belum memilikinya, ikuti panduan ini untuk membuatnya.
4. Tambahkan berikut ini ke claude_desktop_config.json Anda:

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

5. Untuk mendapatkan kunci API, masuk ke dasbor Anda. Ganti <YOUR API key HERE> pada contoh di atas dengan kunci API Anda.
6. Mulai ulang Claude Desktop setelah menyimpan perubahan. Server akan muncul di menu Connectors.

Integrasi Framework

Server MCP juga dapat digunakan dari framework agen Python. Contoh di bawah terhubung ke server yang dihosting melalui HTTP. Untuk menggunakan server lokal, hubungkan dengan perintah stdio uvx dan argumen mcp-ip2location-io, lalu teruskan IP2LOCATION_API_KEY sebagai variabel lingkungan.

Setiap contoh membaca kunci API dari variabel lingkungan IP2LOCATION_API_KEY, sehingga kunci tersebut tidak pernah muncul dalam kode sumber Anda.

LangChain

LangChain menyertakan dukungan MCP dalam namespace langchain.mcp, yang memerlukan LangChain 1.4 atau yang lebih baru.

pip install "langchain[mcp]" langchain-anthropic

import asyncio
import os

from fastmcp.client.transports import StreamableHttpTransport
from langchain.agents import create_agent
from langchain.mcp import MCPAdapter

async def main():
    transport = StreamableHttpTransport(
        "https://mcp.ip2location.io/",
        headers={"X-API-Key": os.environ["IP2LOCATION_API_KEY"]},
    )

    async with MCPAdapter(transport) as adapter:
        tools = await adapter.list_tools()

        agent = create_agent("anthropic:claude-sonnet-5", tools)
        result = await agent.ainvoke({"messages": "Where is 8.8.8.8 located?"})
        print(result["messages"][-1].content)

if __name__ == "__main__":
    asyncio.run(main())

MCPAdapter menerima URL server secara langsung, tetapi objek StreamableHttpTransport diteruskan di sini agar header X-API-Key dapat diatur.

LlamaIndex

pip install llama-index-tools-mcp llama-index-llms-openai

import asyncio
import os

from llama_index.core.agent.workflow import FunctionAgent
from llama_index.llms.openai import OpenAI
from llama_index.tools.mcp import BasicMCPClient, McpToolSpec

async def main():
    client = BasicMCPClient(
        "https://mcp.ip2location.io/",
        headers={"X-API-Key": os.environ["IP2LOCATION_API_KEY"]},
    )

    tools = await McpToolSpec(client=client).to_tool_list_async()

    agent = FunctionAgent(
        tools=tools,
        llm=OpenAI(model="gpt-5-mini"),
        system_prompt="You are a helpful assistant that looks up IP addresses.",
    )

    response = await agent.run("Where is 8.8.8.8 located?")
    print(response)

if __name__ == "__main__":
    asyncio.run(main())

CrewAI

CrewAI membaca server MCP dari kolom mcps pada agen. Fitur ini memerlukan paket mcp terinstal bersama CrewAI.

pip install crewai mcp

import os

from crewai import Agent, Crew, Process, Task
from crewai.mcp import MCPServerHTTP

ip_agent = Agent(
    role="IP Intelligence Analyst",
    goal="Look up geolocation and network information for an IP address.",
    backstory="An analyst who checks IP addresses against IP2Location.io.",
    mcps=[
        MCPServerHTTP(
            url="https://mcp.ip2location.io/",
            headers={"X-API-Key": os.environ["IP2LOCATION_API_KEY"]},
        )
    ],
)

task = Task(
    description="Find the geolocation of 8.8.8.8 and summarize the result.",
    expected_output="A short summary of the IP address location and network data.",
    agent=ip_agent,
)

crew = Crew(agents=[ip_agent], tasks=[task], process=Process.sequential)
print(crew.kickoff())

Pada versi CrewAI yang tidak mendukung kolom mcps, instal crewai-tools[mcp] dan bungkus server dengan MCPServerAdapter dari crewai_tools.

Penggunaan

Setelah server MCP terhubung, ajukan pertanyaan tentang alamat IPv4 atau IPv6 kepada klien MCP Anda menggunakan bahasa alami. Cukup masukkan kueri tentang IP dalam obrolan di Claude Desktop.

Geolokasi IP

Where is the location of (IP)?

Where is (IP) located?

What is the latitude and longitude of (IP)?

Sebagai contoh, berikut hasil untuk IP 8.8.8.8:

Di Claude Desktop, model akan secara otomatis menghasilkan keluaran berdasarkan hasil yang dikembalikan oleh server MCP IP2Location.io.

Pencarian proxy dan keamanan

Bergantung pada paket IP2Location.io yang digunakan:

Is this IP address a proxy: 8.8.8.8?

Beberapa alamat IP

Anda juga dapat menggunakan IP2Location.io Bulk IP Geolocation API untuk melakukan kueri terhadap beberapa alamat IP.

Look up 8.8.8.8 8.8.6.6 9.9.9.9

Server MCP mendeteksi beberapa alamat IP dan mengirimkannya ke IP2Location.io Bulk API jika memungkinkan.

Alamat IP dapat dipisahkan dengan koma, spasi, atau baris baru.

[!NOTE]
Akses ke IP2Location.io Bulk IP Geolocation API memerlukan paket berbayar yang memenuhi syarat.

Variabel Lingkungan

IP2LOCATION_API_KEY

Kunci API IP2Location.io Anda IP2LOCATION_API_KEY.

Paket Free saat ini menyediakan hingga 50,000 kueri IP Geolocation API per bulan dan akses ke informasi IP dasar.

Paket berbayar menyediakan kuota kueri yang lebih tinggi dan atribut tambahan.

Anda dapat mendaftar untuk mendapatkan kunci API gratis, atau berlangganan paket yang lebih tinggi untuk memperoleh data geo-IP yang komprehensif.

Jangan commit kunci API Anda ke repositori Git publik.

Tool MCP

get_geolocation

Deskripsi

• Mengambil geolokasi untuk alamat IP atau sekumpulan alamat IP yang diberikan. Tool ini membantu pengguna mengambil informasi terperinci seperti negara, wilayah, kota, lintang, bujur, kode ZIP, zona waktu, ASN, dan informasi proxy untuk alamat IPv4 atau IPv6. Jika beberapa IP terdeteksi, permintaan akan otomatis diarahkan ke IP2Location.io Bulk API untuk pemrosesan yang efisien.

Argumen

• ip (str): Satu alamat IPv4 atau IPv6, atau beberapa alamat IP yang dipisahkan dengan koma, spasi, atau baris baru.

Contoh satu IP:

8.8.8.8

Contoh beberapa IP:

1.1.1.1, 8.8.8.8, 9.9.9.9

Nilai yang dikembalikan String JSON yang berisi data geolokasi. Jika beberapa IP dikueri, tool ini mengembalikan objek JSON dengan setiap alamat IP sebagai kunci yang dipetakan ke datanya masing-masing.

Bergantung pada paket API Anda, informasi yang dikembalikan dapat mencakup:

Kategori	Informasi yang mungkin tersedia
Lokasi & Geografi	Negara, wilayah, distrik, kota, kode ZIP, lintang, bujur, zona waktu
Jaringan & Konektivitas	ASN, ISP, domain, kecepatan jaringan, kode IDD, kode area, jenis alamat, jenis penggunaan
Autonomous System	ASN, nama AS dan, pada paket yang mendukung, domain AS, CIDR AS, serta jenis penggunaan AS
Seluler	MCC, MNC, merek seluler
Mata Uang & Bahasa	Kode/nama/simbol mata uang dan informasi bahasa
Proxy & Keamanan	Status/jenis proxy, penyedia, terakhir terlihat, informasi ancaman, dan skor penipuan
Data Lainnya	Kategori IAB, informasi cuaca, elevasi, populasi, dan data lain yang bergantung pada paket

Jika permintaan untuk satu IP gagal atau IP tidak valid, tool ini mengembalikan pesan kesalahan sebagai string. Untuk permintaan massal, setiap IP yang gagal akan menghasilkan objek kesalahan yang dipetakan ke alamat IP tersebut tanpa menggagalkan seluruh batch.

Pertanyaan Umum

Dapatkah Anda merekomendasikan layanan geolokasi IP gratis?

Ya. IP2Location.com dan IP2Location.io menyediakan akses gratis atau paket gratis.

IP2Location.io

IP2Location.io menyediakan paket Free yang cocok untuk geolokasi IP dan pencarian jaringan dasar.

Paket Free mencakup hingga 50,000 kueri IP Geolocation API per bulan dan menyediakan informasi dasar, termasuk:

• Alamat IP
• Negara
• Wilayah
• Kota
• Kode ZIP/kode pos
• Lintang dan bujur
• Zona waktu
• ASN
• Nama AS
• Deteksi proxy dasar

REST API IP2Location.io juga dapat dikueri tanpa kunci API untuk penggunaan terbatas hingga 1,000 permintaan per hari.

Paket Free mewajibkan atribusi. Periksa halaman harga IP2Location.io untuk mengetahui batas dan ketentuan terbaru.

Untuk aplikasi MCP yang memerlukan informasi geolokasi dan jaringan langsung melalui klien AI, repositori ini menyediakan antarmuka MCP ke IP2Location.io.

IP2Location.com LITE

IP2Location LITE menyediakan basis data geolokasi IP gratis yang dapat diunduh dan diintegrasikan langsung oleh pengembang ke dalam aplikasi mereka. Bergantung pada edisi basis data, informasi yang tersedia dapat mencakup negara, wilayah, kota, koordinat, kode ZIP, zona waktu, ISP, dan detail domain.

Karena basis data dapat dihosting dan dikueri secara lokal, IP2Location LITE sangat berguna bagi pengembang yang memilih untuk tidak bergantung pada permintaan API eksternal. Basis data ini tersedia dalam berbagai format dan mendukung data IPv4 dan IPv6.

IP2Location LITE merupakan titik awal yang baik bagi pengembang yang mencari solusi geolokasi IP gratis yang dihosting secara lokal.

Apa itu API dan layanan geolokasi IP?

API geolokasi IP mengubah alamat IPv4 atau IPv6 menjadi informasi geografis dan jaringan.

Sebagai contoh, aplikasi dapat mengirim:

8.8.8.8

dan menerima informasi seperti:

• Negara
• Wilayah atau negara bagian
• Kota
• Kode ZIP/kode pos
• Lintang dan bujur
• Zona waktu
• ASN
• ISP
• Domain
• Jenis penggunaan jaringan
• Informasi proxy

Kolom yang tersedia bergantung pada layanan dan tingkat langganan.

Penggunaan umum API geolokasi IP

Geolokasi IP dapat berguna untuk:

• Lokalisasi situs web dan aplikasi
• Pemilihan konten regional
• Analitik lalu lintas
• Pemecahan masalah jaringan
• Investigasi keamanan
• Analisis risiko penipuan
• Konteks login dan autentikasi
• Pengayaan log server
• Riset alamat IP

Server MCP ini memungkinkan pencarian tersebut melalui prompt bahasa alami, sehingga pengguna tidak perlu menyusun permintaan REST API secara manual.

Dapatkah alamat IP dilacak?

Alamat IP dapat dicatat dari waktu ke waktu oleh aplikasi dan diperkaya dengan data geolokasi dan jaringan.

Misalnya, aplikasi keamanan dapat mencatat alamat IP dari peristiwa login dan menggunakan layanan intelijen IP untuk mengidentifikasi:

• Perkiraan negara atau kota
• ASN
• ISP
• Operator jaringan
• Status proxy
• Perubahan jaringan atau wilayah geografis

Hal ini dapat membantu menyelidiki pola lalu lintas atau aktivitas jaringan yang tidak biasa.

Namun, geolokasi IP bukan pelacakan orang atau perangkat yang presisi.

Alamat IP dapat dimiliki oleh:

• Koneksi rumah tangga bersama
• Gateway perusahaan
• Operator seluler
• VPN
• Proxy
• Penyedia cloud
• Pusat data
• Gateway NAT yang digunakan bersama oleh banyak pengguna

Lintang dan bujur yang diberikan oleh layanan geolokasi IP merupakan koordinat geografis perkiraan dan tidak boleh dianggap sebagai koordinat GPS, alamat jalan, atau bukti lokasi fisik seseorang.

Server MCP ini melakukan pencarian alamat IP. Server ini tidak memantau atau melacak alamat IP secara terus-menerus dengan sendirinya.

Dapatkah saya menggunakan IP2Location.io sebagai API "alamat IP saya"?

Ya, REST API IP2Location.io mendukung penggunaan seperti ini.

Biasanya, alamat IP diberikan ke API:

?ip=8.8.8.8

Jika parameter ip tidak disertakan dalam permintaan REST API IP2Location.io langsung, API dapat menggunakan alamat IP yang terkait dengan permintaan masuk untuk pencarian.

Ini berguna bagi aplikasi yang perlu mengetahui informasi tentang IP publik yang membuat permintaan API.

Data "IP saya" yang umum dapat mencakup:

• Alamat IP publik
• Negara
• Wilayah
• Kota
• Koordinat
• Kode ZIP/kode pos
• Zona waktu
• ASN

Tool MCP get_geolocation di repositori ini mengharuskan alamat IP diberikan sebagai argumennya, sehingga penggunaan MCP terutama dirancang untuk mencari alamat IP yang diberikan dalam percakapan.

Tool apa yang terbaik untuk pencarian ASN dan alamat IP?

Tool terbaik bergantung pada informasi yang Anda perlukan.

IP2Location.io

IP2Location.io berguna jika Anda memerlukan informasi ASN dan geolokasi IP dari pencarian yang sama.

Informasi pencarian dasar mencakup:

• ASN
• Nama Autonomous System

Data IP2Location.io tingkat lebih tinggi juga dapat mencakup:

• Nomor AS
• Nama AS
• Domain AS
• CIDR AS
• Jenis penggunaan AS

Melalui server MCP ini, Anda dapat bertanya:

What is the ASN of 8.8.8.8?

atau:

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

RDAP dan WHOIS

Layanan RDAP dan WHOIS berguna jika Anda memerlukan informasi pendaftaran tentang blok alamat IP dan organisasi.

Layanan ini sangat berguna untuk mengidentifikasi catatan Regional Internet Registry yang terkait dengan rentang IP.

Tool BGP

Looking glass BGP dan layanan analisis perutean lebih sesuai jika Anda memerlukan informasi tentang:

• Pengumuman rute
• Prefiks
• Jalur BGP
• Peering
• Perubahan perutean
• ASN yang saat ini mengumumkan suatu jaringan

API intelijen IP

Layanan intelijen IP lebih sesuai jika aplikasi memerlukan informasi terstruktur yang menggabungkan beberapa kumpulan data, seperti:

• Geolokasi
• ASN
• ISP
• Deteksi proxy
• Deteksi VPN
• Klasifikasi jaringan
• Data keamanan

Bagi pengguna MCP yang menginginkan informasi geolokasi dan ASN dalam alur kerja yang sama, proyek ini menyediakan antarmuka praktis ke IP2Location.io.

Memahami Pencarian ASN

Autonomous System Number (ASN) mengidentifikasi Autonomous System: jaringan atau kumpulan prefiks IP yang dioperasikan berdasarkan kebijakan perutean bersama.

Contoh organisasi yang memiliki ASN meliputi:

• Penyedia layanan internet
• Penyedia hosting cloud
• Jaringan pengiriman konten
• Universitas
• Perusahaan besar
• Perusahaan telekomunikasi

Informasi ASN dapat berguna saat menyelidiki IP karena dapat menunjukkan jaringan yang bertanggung jawab merutekan alamat tersebut.

Misalnya:

8.8.8.8

terkait dengan:

ASN: 15169
AS: Google LLC

Pencarian ASN umumnya digunakan untuk:

• Pemecahan masalah jaringan
• Investigasi keamanan
• Analisis lalu lintas
• Mengidentifikasi penyedia hosting
• Mengelompokkan lalu lintas berdasarkan jaringan
• Menyelidiki alamat IP yang mencurigakan

Akurasi dan Batasan Geolokasi IP

Geolokasi IP memberikan perkiraan lokasi geografis berdasarkan informasi jaringan dan alokasi IP.

Geolokasi IP tidak boleh dianggap sebagai lokasi fisik pasti pengguna atau perangkat.

Akurasi dapat dipengaruhi oleh:

• VPN
• Server proxy
• Jaringan seluler
• Jaringan perusahaan
• NAT tingkat operator
• Koneksi satelit
• Infrastruktur cloud
• Perubahan perutean ISP dan alokasi alamat

Hasil tingkat negara umumnya lebih andal daripada hasil tingkat kota atau koordinat yang lebih spesifik.

Gunakan geolokasi IP sebagai informasi kontekstual jaringan, bukan sebagai pelacakan fisik yang presisi.

Paket IP2Location.io

Jumlah informasi yang dikembalikan bergantung pada paket IP2Location.io.

Paket Free menyediakan geolokasi dasar, informasi ASN dasar, dan deteksi proxy dasar.

Paket tingkat lebih tinggi dapat menyediakan informasi tambahan seperti:

• ISP
• Domain
• Kecepatan jaringan
• Jenis penggunaan
• Informasi jaringan seluler
• Informasi Autonomous System terperinci
• Informasi proxy terperinci
• Deteksi VPN
• Deteksi Tor
• Deteksi pusat data
• Informasi ancaman
• Skor penipuan
• Atribut geolokasi tambahan

Untuk mengetahui batas kueri, kolom, dan harga terbaru, lihat:

• Harga IP2Location.io
• Dokumentasi API IP2Location.io

Sumber daya

• IP2Location.io
• Dokumentasi API IP2Location.io
• Harga IP2Location.io
• API Geolokasi IP Massal IP2Location.io

Lisensi

Lihat file LICENSE.TXT.