IP2Location.io

chính thức

Tích hợp API IP2Location.io để truy xuất thông tin định vị địa lý cho một địa chỉ IP.

GitHub
17
Dùng thử MCP nàyĐược tài trợ

Bạn có thể làm gì với IP2Location Io MCP?

  • Tra cứu định vị địa lý — Yêu cầu quốc gia, vùng, thành phố, tọa độ, mã ZIP hoặc múi giờ của bất kỳ địa chỉ IPv4 hoặc IPv6 nào qua get_geolocation.
  • ASN và thông tin mạng — Xác định Số hệ thống tự trị, ISP, tên miền và loại sử dụng mạng liên kết với một địa chỉ IP.
  • Sàng lọc proxy và bảo mật — Kiểm tra xem một địa chỉ IP có phải là proxy hay không và truy xuất thông tin về mối đe dọa hoặc gian lận trên các gói hỗ trợ.
  • Làm phong phú IP hàng loạt — Truy vấn nhiều IP trong một lời nhắc (phân tách bằng dấu phẩy, khoảng trắng hoặc dòng mới) và tự động nhận kết quả cho từng địa chỉ.

Tài liệu

Máy chủ MCP IP2Location.io

Máy chủ MCP IP2Location.io là một máy chủ Giao thức Ngữ cảnh Mô hình (MCP) cho phép các ứng dụng AI tương thích MCP thực hiện tra cứu định vị địa lý địa chỉ IP và thông tin tình báo mạng bằng API IP2Location.io.

Cung cấp địa chỉ IPv4 hoặc IPv6 và máy chủ MCP có thể truy xuất thông tin như vị trí địa lý, ASN, ISP, tên miền, loại mạng và thông tin proxy, tùy thuộc vào gói API IP2Location.io của bạn.

Điều này hữu ích cho việc điều tra IP, khắc phục sự cố mạng, phân tích lưu lượng, bản địa hóa, phân tích bảo mật và làm phong phú các địa chỉ IP tìm thấy trong nhật ký hoặc các tập dữ liệu khác.

mcp-ip2location-io MCP server

Trust Score

Tính năng

  • Dữ liệu định vị địa lý toàn diện: Truy xuất quốc gia, vùng, thành phố, mã ZIP/bưu chính, vĩ độ, kinh độ, múi giờ và các thông tin vị trí khác.
  • Tra cứu ASN: Xác định Số hệ thống tự trị (ASN) và Hệ thống tự trị (AS) liên kết với một địa chỉ IP.
  • Thông tin tình báo mạng: Truy xuất thông tin như ISP, tên miền, tốc độ kết nối, loại sử dụng và các thuộc tính mạng khác tùy thuộc vào gói của bạn.
  • Thông tin proxy và bảo mật: Phát hiện thông tin liên quan đến proxy và trên các gói được hỗ trợ, thông tin bổ sung về VPN, Tor, trung tâm dữ liệu, mối đe dọa và gian lận.
  • Hỗ trợ IPv4 và IPv6: Truy vấn cả địa chỉ IPv4 và IPv6.
  • Tra cứu IP hàng loạt: Gửi nhiều địa chỉ IP trong một lời nhắc và tự động sử dụng API hàng loạt IP2Location.io khi khả dụng.
  • Tích hợp MCP: Sử dụng thông tin tình báo IP trực tiếp từ các ứng dụng AI tương thích MCP.
  • Yêu cầu không đồng bộ: Sử dụng httpx cho các yêu cầu API không đồng bộ.

[!NOTE] Các trường được trả về bởi IP2Location.io phụ thuộc vào gói đăng ký API của bạn.

Yêu cầu

Có hai cách để sử dụng máy chủ MCP này.

Máy chủ MCP lưu trữ trên đám mây

Được khuyến nghị khi bạn muốn kết nối trực tiếp đến máy chủ MCP IP2Location.io được lưu trữ.

Bạn cần:

  • Một ứng dụng khách tương thích MCP như Claude Desktop
  • Node.js / npx
  • Khóa API IP2Location.io

Máy chủ MCP cục bộ

Sử dụng tùy chọn này khi bạn muốn chạy máy chủ MCP cục bộ.

Bạn cần:

  • Python 3.13 trở lên
  • uv
  • Một ứng dụng khách tương thích MCP như Claude Desktop
  • Khóa API IP2Location.io

Bạn có thể đăng ký khóa API IP2Location.io miễn phí. Gói miễn phí cung cấp tối đa 50.000 truy vấn API định vị địa lý IP mỗi tháng.

API REST IP2Location.io cơ bản cũng hỗ trợ truy cập không cần khóa giới hạn tối đa 1.000 truy vấn mỗi ngày. Đối với máy chủ MCP này, việc cấu hình khóa API được khuyến nghị và được sử dụng trong các ví dụ thiết lập bên dưới.

Thiết lập

Bạn có thể sử dụng máy chủ MCP này trong Claude Desktop theo một trong các cách sau:

  • Máy chủ MCP lưu trữ trên đám mây: Được khuyến nghị nếu bạn muốn kết nối trực tiếp đến máy chủ MCP IP2Location.io được lưu trữ.
  • Máy chủ MCP cục bộ: Sử dụng tùy chọn này nếu bạn muốn tải xuống và chạy máy chủ MCP gốc trên máy của mình.

Tùy chọn 1: Máy chủ MCP lưu trữ trên đám mây

Thực hiện theo các bước sau để kết nối Claude Desktop với máy chủ MCP IP2Location.io được lưu trữ.

  1. Đảm bảo bạn đã cài đặt Claude Desktop. Nếu chưa cài đặt, hãy tải xuống từ đây cho Windows và macOS, hoặc làm theo hướng dẫn này cho người dùng Linux.
  2. Mở tệp claude_desktop_config.json bằng trình soạn thảo bạn chọn. Nếu bạn chưa có, hãy làm theo hướng dẫn này để tạo một tệp.
  3. Thêm nội dung sau vào claude_desktop_config.json của bạn:
{
  "mcpServers": {
    "ip2location": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://mcp.ip2location.io/",
        "--header",
        "X-API-Key:YOUR_API_KEY"
      ]
    }
  }
}
  1. Thay thế YOUR_API_KEY bằng khóa API IP2Location.io thực tế của bạn. Để lấy khóa API, hãy đăng nhập vào bảng điều khiển của bạn.
  2. Khởi động lại Claude Desktop sau khi lưu các thay đổi và bạn sẽ thấy máy chủ MCP xuất hiện trong menu Connectors.

Tùy chọn 2: Máy chủ MCP cục bộ

Thực hiện theo các bước sau nếu bạn muốn chạy máy chủ MCP cục bộ.

  1. Thiết lập trình quản lý gói uv. Bạn có thể tham khảo hướng dẫn để thực hiện.
  2. Đảm bảo bạn đã cài đặt Claude Desktop. Nếu chưa cài đặt, hãy tải xuống từ đây cho Windows và macOS, hoặc làm theo hướng dẫn này cho người dùng Linux.
  3. Mở tệp claude_desktop_config.json bằng trình soạn thảo bạn chọn. Nếu bạn chưa có, hãy làm theo hướng dẫn này để tạo một tệp.
  4. Thêm nội dung sau vào claude_desktop_config.json của bạn:
{
  "mcpServers": {
    "ip2locationio": {
      "command": "uvx",
      "args": [
        "mcp-ip2location-io"
      ],
      "env": {
        "IP2LOCATION_API_KEY": "<YOUR API key HERE>"
      }
    }
  }
}
  1. Để lấy khóa API, hãy đăng nhập vào bảng điều khiển của bạn. Thay thế <YOUR API key HERE> trong ví dụ trên bằng khóa API thực tế của bạn.
  2. Khởi động lại Claude Desktop sau khi lưu các thay đổi và bạn sẽ thấy nó xuất hiện trong menu Connectors.

Cách sử dụng

Khi máy chủ MCP đã được kết nối, hãy hỏi ứng dụng khách MCP của bạn các câu hỏi về địa chỉ IPv4 hoặc IPv6 bằng ngôn ngữ tự nhiên. Chỉ cần nhập truy vấn của bạn về IP trong cuộc trò chuyện trong Claude Desktop.

Định vị địa lý IP

Where is the location of (IP)?

Where is (IP) located?

What is the latitude and longitude of (IP)?

Ví dụ: dưới đây là kết quả của IP 8.8.8.8:

The output of the IP 8.8.8.8

Trong Claude Desktop, mô hình sẽ tự động tạo đầu ra dựa trên kết quả được trả về bởi máy chủ MCP IP2Location.io.

Tra cứu proxy và bảo mật

Tùy thuộc vào gói IP2Location.io đang sử dụng:

Is this IP address a proxy: 8.8.8.8?

Nhiều địa chỉ IP

Bạn cũng có thể sử dụng API định vị địa lý IP hàng loạt IP2Location.io để truy vấn nhiều địa chỉ IP.

Look up 8.8.8.8 8.8.6.6 9.9.9.9

Máy chủ MCP phát hiện nhiều địa chỉ IP và gửi chúng đến API hàng loạt IP2Location.io khi có thể.

Các địa chỉ IP có thể được phân tách bằng dấu phẩy, khoảng trắng hoặc dòng mới.

[!NOTE]
Quyền truy cập API định vị địa lý IP hàng loạt IP2Location.io yêu cầu gói trả phí đủ điều kiện.

Biến môi trường

IP2LOCATION_API_KEY

Khóa API IP2Location.io của bạn IP2LOCATION_API_KEY.

Gói miễn phí hiện cung cấp tối đa 50.000 truy vấn API định vị địa lý IP mỗi tháng và quyền truy cập vào thông tin IP cơ bản.

Các gói trả phí cung cấp hạn mức truy vấn cao hơn và các thuộc tính bổ sung.

Bạn có thể đăng ký khóa API miễn phí hoặc đăng ký gói cao hơn để có dữ liệu geo-ip toàn diện.

Không cam kết khóa API của bạn vào kho lưu trữ Git công khai.

Công cụ MCP

get_geolocation

Mô tả

  • Truy xuất định vị địa lý cho địa chỉ IP đã cho hoặc một loạt địa chỉ IP. Nó giúp người dùng truy xuất thông tin chi tiết như quốc gia, vùng, thành phố, vĩ độ, kinh độ, mã ZIP, múi giờ, ASN và thông tin proxy cho bất kỳ địa chỉ IPv4 hoặc IPv6 nào. Nó tự động định tuyến các yêu cầu đến API hàng loạt IP2Location.io để xử lý hiệu quả khi phát hiện nhiều IP.

Đối số

  • ip (str): Một địa chỉ IPv4 hoặc IPv6 hoặc nhiều địa chỉ IP được phân tách bằng dấu phẩy, khoảng trắng hoặc dòng mới.

Ví dụ IP đơn:

8.8.8.8

Ví dụ nhiều IP:

1.1.1.1, 8.8.8.8, 9.9.9.9

Giá trị trả về Một chuỗi JSON chứa dữ liệu định vị địa lý. Nếu truy vấn nhiều IP, nó trả về một đối tượng JSON trong đó mỗi khóa là một địa chỉ IP được ánh xạ đến dữ liệu tương ứng của nó.

Tùy thuộc vào gói API của bạn, thông tin trả về có thể bao gồm:

Danh mụcThông tin có thể có
Vị trí & Địa lýQuốc gia, vùng, quận, thành phố, mã ZIP, vĩ độ, kinh độ, múi giờ
Mạng & Kết nốiASN, ISP, tên miền, tốc độ mạng, mã IDD, mã vùng, loại địa chỉ, loại sử dụng
Hệ thống tự trịASN, tên AS và trên các gói được hỗ trợ, tên miền AS, CIDR AS và loại sử dụng AS
Di độngMCC, MNC, thương hiệu di động
Tiền tệ & Ngôn ngữMã/tên/ký hiệu tiền tệ và thông tin ngôn ngữ
Proxy & Bảo mậtTrạng thái/loại proxy, nhà cung cấp, lần nhìn thấy cuối, thông tin mối đe dọa và điểm gian lận
Dữ liệu khácDanh mục IAB, thông tin thời tiết, độ cao, dân số và dữ liệu phụ thuộc gói khác

Nếu một yêu cầu IP đơn thất bại hoặc IP không hợp lệ, công cụ trả về thông báo lỗi dưới dạng chuỗi. Đối với các yêu cầu hàng loạt, bất kỳ IP riêng lẻ nào thất bại sẽ trả về một đối tượng lỗi được ánh xạ đến địa chỉ IP cụ thể đó mà không làm thất bại toàn bộ lô.

Câu hỏi thường gặp

Bạn có thể giới thiệu dịch vụ định vị địa lý IP miễn phí không?

Có. IP2Location.com và IP2Location.io cung cấp quyền truy cập miễn phí hoặc các gói miễn phí.

IP2Location.io

IP2Location.io cung cấp gói miễn phí phù hợp cho định vị địa lý IP và tra cứu mạng cơ bản.

Gói miễn phí bao gồm tối đa 50.000 truy vấn API định vị địa lý IP mỗi tháng và cung cấp thông tin cơ bản bao gồm:

  • Địa chỉ IP
  • Quốc gia
  • Vùng
  • Thành phố
  • Mã ZIP/bưu chính
  • Vĩ độ và kinh độ
  • Múi giờ
  • ASN
  • Tên AS
  • Phát hiện proxy cơ bản

API REST IP2Location.io cũng có thể được truy vấn mà không cần khóa API với mức sử dụng giới hạn tối đa 1.000 yêu cầu mỗi ngày.

Gói miễn phí yêu cầu ghi nhận nguồn. Kiểm tra trang giá IP2Location.io để biết các giới hạn và điều kiện hiện tại.

Đối với các ứng dụng MCP cần thông tin định vị địa lý và mạng trực tiếp thông qua ứng dụng khách AI, kho lưu trữ này cung cấp giao diện MCP cho IP2Location.io.

IP2Location.com LITE

IP2Location LITE cung cấp cơ sở dữ liệu định vị địa lý IP miễn phí mà các nhà phát triển có thể tải xuống và tích hợp trực tiếp vào ứng dụng của họ. Tùy thuộc vào phiên bản cơ sở dữ liệu, nó có thể cung cấp thông tin như quốc gia, vùng, thành phố, tọa độ, mã ZIP, múi giờ, ISP và chi tiết tên miền.

Vì các cơ sở dữ liệu có thể được lưu trữ và truy vấn cục bộ, IP2Location LITE đặc biệt hữu ích cho các nhà phát triển thích không phụ thuộc vào các yêu cầu API bên ngoài. Nó có sẵn ở nhiều định dạng và hỗ trợ dữ liệu IPv4 và IPv6.

IP2Location LITE là điểm khởi đầu tốt cho các nhà phát triển đang tìm kiếm giải pháp định vị địa lý IP miễn phí, lưu trữ cục bộ.

API và dịch vụ định vị địa lý IP là gì?

API định vị địa lý IP chuyển đổi địa chỉ IPv4 hoặc IPv6 thành thông tin địa lý và mạng.

Ví dụ: một ứng dụng có thể gửi:

8.8.8.8

và nhận thông tin như:

  • Quốc gia
  • Vùng hoặc tiểu bang
  • Thành phố
  • Mã ZIP/bưu chính
  • Vĩ độ và kinh độ
  • Múi giờ
  • ASN
  • ISP
  • Tên miền
  • Loại sử dụng mạng
  • Thông tin proxy

Các trường chính xác phụ thuộc vào dịch vụ và mức đăng ký.

Các ứng dụng phổ biến của API định vị địa lý IP

Định vị địa lý IP có thể hữu ích cho:

  • Bản địa hóa trang web và ứng dụng
  • Lựa chọn nội dung theo khu vực
  • Phân tích lưu lượng
  • Khắc phục sự cố mạng
  • Điều tra bảo mật
  • Phân tích rủi ro gian lận
  • Ngữ cảnh đăng nhập và xác thực
  • Làm phong phú nhật ký máy chủ
  • Nghiên cứu địa chỉ IP

Máy chủ MCP này giúp các tra cứu này có thể truy cập thông qua các lời nhắc ngôn ngữ tự nhiên thay vì yêu cầu người dùng xây dựng các yêu cầu REST API theo cách thủ công.

Địa chỉ IP có thể bị theo dõi không?

Một địa chỉ IP có thể được ghi lại theo thời gian bởi một ứng dụng và được làm phong phú với dữ liệu định vị địa lý và mạng.

Ví dụ: một ứng dụng bảo mật có thể ghi lại các địa chỉ IP từ các sự kiện đăng nhập và sử dụng dịch vụ thông tin tình báo IP để xác định:

  • Quốc gia hoặc thành phố gần đúng
  • ASN
  • ISP
  • Nhà điều hành mạng
  • Trạng thái proxy
  • Thay đổi trong mạng hoặc khu vực địa lý

Điều này có thể giúp điều tra các mẫu lưu lượng hoặc hoạt động mạng bất thường.

Tuy nhiên, định vị địa lý IP không phải là theo dõi người hoặc thiết bị chính xác.

Một địa chỉ IP có thể thuộc về:

  • Kết nối hộ gia đình dùng chung
  • Cổng mạng doanh nghiệp
  • Nhà cung cấp di động
  • VPN
  • Proxy
  • Nhà cung cấp đám mây
  • Trung tâm dữ liệu
  • Cổng NAT được chia sẻ bởi nhiều người dùng

Vĩ độ và kinh độ được trả về bởi dịch vụ định vị địa lý IP là tọa độ địa lý gần đúng và không nên được hiểu là tọa độ GPS, địa chỉ đường phố hoặc bằng chứng về vị trí vật lý của một cá nhân.

Máy chủ MCP này thực hiện tra cứu địa chỉ IP. Nó không liên tục giám sát hoặc theo dõi các địa chỉ IP.

Tôi có thể sử dụng IP2Location.io như API "địa chỉ IP của tôi" không?

Có, API REST IP2Location.io hỗ trợ loại trường hợp sử dụng này.

Thông thường, một địa chỉ IP được truyền đến API:

?ip=8.8.8.8

Nếu tham số ip bị bỏ qua trong yêu cầu API REST IP2Location.io trực tiếp, API có thể sử dụng địa chỉ IP liên kết với yêu cầu đến để tra cứu.

Điều này hữu ích cho các ứng dụng cần xác định thông tin về IP công khai thực hiện yêu cầu API.

Dữ liệu "IP của tôi" điển hình có thể bao gồm:

  • Địa chỉ IP công khai
  • Quốc gia
  • Vùng
  • Thành phố
  • Tọa độ
  • Mã ZIP/bưu chính
  • Múi giờ
  • ASN

Công cụ MCP get_geolocation trong kho lưu trữ này mong đợi một địa chỉ IP làm đối số, vì vậy việc sử dụng MCP chủ yếu được thiết kế để tra cứu một địa chỉ IP được cung cấp trong cuộc trò chuyện.

Công cụ nào tốt nhất để tra cứu ASN và địa chỉ IP?

Công cụ tốt nhất phụ thuộc vào thông tin bạn cần.

IP2Location.io

IP2Location.io hữu ích khi bạn cần cả thông tin ASN và định vị địa lý IP từ cùng một lần tra cứu.

Thông tin tra cứu cơ bản bao gồm:

  • ASN
  • Tên Hệ thống Tự trị

Dữ liệu IP2Location.io cấp cao hơn có thể bao gồm thêm:

  • Số AS
  • Tên AS
  • Tên miền AS
  • CIDR AS
  • Loại sử dụng AS

Thông qua máy chủ MCP này, bạn có thể hỏi:

What is the ASN of 8.8.8.8?

hoặc:

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

RDAP và WHOIS

Dịch vụ RDAP và WHOIS hữu ích khi bạn cần thông tin đăng ký về các khối địa chỉ IP và tổ chức.

Chúng đặc biệt hữu ích để xác định bản ghi Sổ đăng ký Internet Khu vực liên kết với một dải IP.

Công cụ BGP

Kính lúp BGP và dịch vụ phân tích định tuyến phù hợp hơn khi bạn cần thông tin về:

  • Thông báo tuyến đường
  • Tiền tố
  • Đường dẫn BGP
  • Kết nối ngang hàng
  • Thay đổi định tuyến
  • ASN nào hiện đang công bố một mạng

API thông minh IP

Dịch vụ thông minh IP được ưa chuộng khi một ứng dụng cần thông tin có cấu trúc kết hợp nhiều tập dữ liệu, chẳng hạn như:

  • Định vị địa lý
  • ASN
  • ISP
  • Phát hiện proxy
  • Phát hiện VPN
  • Phân loại mạng
  • Dữ liệu bảo mật

Đối với người dùng MCP muốn có thông tin định vị địa lý và ASN trong cùng một quy trình làm việc, dự án này cung cấp một giao diện thuận tiện cho IP2Location.io.

Hiểu về Tra cứu ASN

Số Hệ thống Tự trị (ASN) xác định một Hệ thống Tự trị: một mạng hoặc tập hợp các tiền tố IP được vận hành theo một chính sách định tuyến chung.

Ví dụ về các tổ chức có ASN bao gồm:

  • Nhà cung cấp dịch vụ Internet
  • Nhà cung cấp lưu trữ đám mây
  • Mạng phân phối nội dung
  • Trường đại học
  • Doanh nghiệp lớn
  • Công ty viễn thông

Thông tin ASN có thể hữu ích khi điều tra một IP vì nó có thể tiết lộ mạng nào chịu trách nhiệm định tuyến địa chỉ đó.

Ví dụ:

8.8.8.8

được liên kết với:

ASN: 15169
AS: Google LLC

Tra cứu ASN thường được sử dụng cho:

  • Khắc phục sự cố mạng
  • Điều tra bảo mật
  • Phân tích lưu lượng
  • Xác định nhà cung cấp lưu trữ
  • Nhóm lưu lượng theo mạng
  • Điều tra các địa chỉ IP đáng ngờ

Độ chính xác và Giới hạn của Định vị Địa lý IP

Định vị địa lý IP cung cấp vị trí địa lý ước tính dựa trên thông tin mạng và phân bổ IP.

Không nên coi đây là vị trí vật lý chính xác của người dùng hoặc thiết bị.

Độ chính xác có thể bị ảnh hưởng bởi:

  • VPN
  • Máy chủ proxy
  • Mạng di động
  • Mạng doanh nghiệp
  • NAT cấp nhà cung cấp
  • Kết nối vệ tinh
  • Cơ sở hạ tầng đám mây
  • Thay đổi định tuyến và phân bổ địa chỉ ISP

Kết quả cấp quốc gia thường đáng tin cậy hơn kết quả cấp thành phố hoặc tọa độ chính xác.

Sử dụng định vị địa lý IP như thông tin mạng ngữ cảnh thay vì theo dõi vật lý chính xác.

Gói IP2Location.io

Lượng thông tin trả về phụ thuộc vào gói IP2Location.io.

Gói miễn phí cung cấp định vị địa lý cơ bản, thông tin ASN cơ bản và phát hiện proxy cơ bản.

Các gói cấp cao hơn có thể cung cấp thông tin bổ sung như:

  • ISP
  • Tên miền
  • Tốc độ mạng
  • Loại sử dụng
  • Thông tin mạng di động
  • Thông tin Hệ thống Tự trị chi tiết
  • Thông tin proxy chi tiết
  • Phát hiện VPN
  • Phát hiện Tor
  • Phát hiện trung tâm dữ liệu
  • Thông tin mối đe dọa
  • Điểm gian lận
  • Thuộc tính định vị địa lý bổ sung

Để biết giới hạn truy vấn, trường dữ liệu và giá mới nhất, hãy tham khảo:

Tài nguyên

Giấy phép

Xem tệp LICENSE.TXT.