IP2Location.io MCP Server

resmi

Integrasi API IP2Location.io untuk mengambil informasi geolokasi dari alamat IP.

Dokumentasi

Server MCP IP2Location.io

Ini adalah implementasi server Model Context Protocol (MCP) sederhana untuk API IP2Location.io. Server ini akan mengembalikan informasi geolokasi terperinci untuk alamat IPv4 atau IPv6 yang diberikan.

Fitur

Data Geolokasi Komprehensif: Mengambil berbagai informasi, termasuk negara, wilayah, kota, lintang, bujur, kode pos, zona waktu, dan lainnya.
Detail Jaringan: Menyediakan data terkait jaringan seperti ASN, ISP, domain, dan kecepatan jaringan.
Wawasan Keamanan: Mendeteksi informasi proksi, termasuk tipe proksi dan penyedia.
Integrasi Sederhana: Dibangun sebagai alat FastMCP, memungkinkan integrasi mudah ke dalam sistem yang kompatibel.
Asinkron: Memanfaatkan httpx untuk permintaan API asinkron non-pemblokiran.

Persyaratan

Server MCP ini mendukung kueri tanpa kunci API, dengan batasan 1.000 kueri per hari. Anda juga dapat mendaftar untuk kunci API gratis dan menikmati hingga 50.000 kueri per bulan.

Jika Anda menggunakan server MCP yang dihosting di cloud, Anda hanya memerlukan Claude Desktop dan npx, karena server dihosting dari jarak jauh. Jika Anda ingin menjalankan server MCP asli secara lokal, pengaturan lokal menggunakan uv, yang dapat diinstal dengan mengikuti panduan.

Pengaturan

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 ini jika Anda ingin mengunduh dan menjalankan server MCP asli di mesin Anda sendiri.

Opsi 1: Server MCP yang dihosting di cloud

Ikuti langkah-langkah di bawah ini untuk menggunakan server MCP IP2Location.io yang dihosting di cloud dengan Claude Desktop:

Pastikan Anda telah menginstal Claude Desktop. Jika Anda belum menginstalnya, unduh dari sini untuk Windows dan macOS, atau ikuti panduan ini untuk pengguna Linux.
Buka file claude_desktop_config.json di editor pilihan Anda. Jika Anda belum memilikinya, ikuti panduan ini untuk membuatnya.
Tambahkan yang berikut ke claude_desktop_config.json Anda:

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

Ganti YOUR_API_KEY dengan kunci API IP2Location.io Anda yang sebenarnya. Untuk mendapatkan kunci API Anda, masuk ke dasbor Anda.
Mulai ulang Claude Desktop setelah menyimpan perubahan, dan Anda akan melihat server MCP muncul di menu Connectors.

Opsi 2: Server MCP lokal

Ikuti langkah-langkah di bawah ini jika Anda ingin menjalankan server MCP asli secara lokal dengan Claude Desktop:

Siapkan manajer paket uv. Anda dapat merujuk ke panduan untuk melakukannya.
Pastikan Anda telah menginstal Claude Desktop. Jika Anda belum menginstalnya, unduh dari sini untuk Windows dan macOS, atau ikuti panduan ini untuk pengguna Linux.
Buka file claude_desktop_config.json di editor pilihan Anda. Jika Anda belum memilikinya, ikuti panduan ini untuk membuatnya.
Tambahkan yang berikut ke claude_desktop_config.json Anda:

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

Untuk mendapatkan kunci API Anda, masuk ke dasbor Anda. Ganti <YOUR API key HERE> dalam contoh di atas dengan kunci API Anda yang sebenarnya.
Mulai ulang Claude Desktop setelah menyimpan perubahan, dan Anda akan melihatnya muncul di menu Connectors.

Penggunaan

Cukup masukkan kueri Anda tentang IP dalam obrolan di Claude Desktop. Beberapa contoh kueri adalah:

Di mana lokasi (IP)?
Di mana (IP) berada?
Apa koordinat dari (IP)?

Misalnya, di bawah ini adalah hasil dari IP 8.8.8.8:

The output of the IP 8.8.8.8

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

Anda juga dapat memanfaatkan API Geolokasi IP Massal IP2Location.io untuk menanyakan beberapa alamat IP. Cukup masukkan semua alamat IP dengan spasi di antara setiap alamat IP. Misalnya 8.8.8.8 8.8.6.6.

[!CATATAN]
API Geolokasi IP Massal IP2Location.io memerlukan paket berbayar agar berfungsi.

Variabel Lingkungan

IP2LOCATION_API_KEY

Kunci API IP2Location.io, yang memungkinkan Anda menanyakan hingga 50.000 per bulan dan detail lebih lanjut dari alamat IP. Anda dapat mendaftar untuk kunci API gratis, atau berlangganan paket untuk menikmati lebih banyak manfaat.

Alat

get_geolocation

Deskripsi Ambil geolokasi untuk alamat IP yang diberikan atau sekumpulan alamat IP. Ini membantu pengguna mengambil informasi terperinci seperti negara, wilayah, kota, lintang, bujur, kode pos, zona waktu, ASN, dan informasi proksi untuk alamat IPv4 atau IPv6 apa pun. Ini secara otomatis mengarahkan permintaan ke API Massal IP2Location.io untuk pemrosesan yang efisien ketika beberapa IP terdeteksi.

Argumen

ip (str): Alamat IP (IPv4 atau IPv6) yang akan dianalisis. Anda dapat menanyakan beberapa IP sekaligus dengan meneruskannya sebagai string tunggal yang dipisahkan oleh koma, spasi, atau baris baru (mis., "1.1.1.1, 2.2.2.2").

Mengembalikan String JSON yang berisi data geolokasi. Jika beberapa IP ditanyakan, ini mengembalikan objek JSON di mana setiap kunci adalah alamat IP yang dipetakan ke datanya masing-masing. Hasilnya dapat mencakup bidang berikut, tergantung pada paket API Anda:

Lokasi & Geografi: Negara, wilayah, distrik, kota, kode pos, lintang & bujur, zona waktu.
Jaringan & Konektivitas: ASN (Nomor Sistem Otonom), ISP (Penyedia Layanan Internet), domain, kecepatan bersih, kode IDD, kode area, tipe alamat, tipe penggunaan.
Informasi Seluler: MNC (Kode Jaringan Seluler), MCC (Kode Negara Seluler), Merek Seluler.
Mata Uang & Bahasa: kode mata uang, nama mata uang, simbol mata uang, kode bahasa, nama bahasa.
Proksi & Keamanan: tipe proksi, terakhir terlihat, tingkat/tipe ancaman, penyedia proksi, skor penipuan.
Lainnya: Kategori IAB, cuaca, elevasi, populasi, dan lainnya.

Jika permintaan IP tunggal gagal atau IP tidak valid, alat ini mengembalikan pesan kesalahan sebagai string. Untuk permintaan massal, setiap IP individu yang gagal akan mengembalikan objek kesalahan yang dipetakan ke alamat IP spesifik tersebut tanpa menggagalkan seluruh batch.

Lisensi

Lihat file LICENSE.