IP2Location.io

Máy chủ MCP IP2Location.io

Đây là một triển khai máy chủ Giao thức Ngữ cảnh Mô hình (MCP) đơn giản cho API IP2Location.io. Nó sẽ trả về thông tin định vị địa lý chi tiết cho bất kỳ địa chỉ IPv4 hoặc IPv6 nào được cung cấp.

Tính năng

• Dữ liệu Định vị Địa lý Toàn diện: Truy xuất nhiều loại thông tin, bao gồm quốc gia, khu vực, thành phố, vĩ độ, kinh độ, mã ZIP, múi giờ và hơn thế nữa.
• Chi tiết Mạng: Cung cấp dữ liệu liên quan đến mạng như ASN, ISP, tên miền và tốc độ mạng.
• Thông tin Bảo mật: Phát hiện thông tin proxy, bao gồm loại proxy và nhà cung cấp.
• Tích hợp Đơn giản: Được xây dựng như một công cụ FastMCP, cho phép tích hợp dễ dàng vào các hệ thống tương thích.
• Bất đồng bộ: Sử dụng httpx cho các yêu cầu API bất đồng bộ không chặn.

Yêu cầu

Máy chủ MCP này hỗ trợ truy vấn không cần khóa API, với giới hạn 1.000 truy vấn mỗi ngày. Bạn cũng có thể đăng ký khóa API miễn phí và tận hưởng tối đa 50.000 truy vấn mỗi tháng.

Nếu bạn sử dụng máy chủ MCP được lưu trữ trên đám mây, bạn chỉ cần Claude Desktop và npx, vì máy chủ được lưu trữ từ xa. Nếu bạn muốn chạy máy chủ MCP gốc cục bộ, thiết lập cục bộ sử dụng uv, có thể được cài đặt bằng cách làm theo hướng dẫn.

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 được 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 với 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 riêng mình.

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

Làm theo các bước dưới đây để sử dụng máy chủ MCP IP2Location.io được lưu trữ trên đám mây với Claude Desktop:

1. Đảm bảo bạn đã cài đặt Claude Desktop. Nếu bạn 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 trong trình soạn thảo bạn chọn. Nếu bạn chưa có tệp này, 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"
      ]
    }
  }
}

4. 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.
5. 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ộ

Làm theo các bước dưới đây nếu bạn muốn chạy máy chủ MCP gốc cục bộ với Claude Desktop:

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 bạn 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 trong trình soạn thảo bạn chọn. Nếu bạn chưa có tệp này, 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>"
      }
    }
  }
}

5. Để lấy khóa API của bạn, hãy đăng nhập vào bảng điều khiển. Thay thế <YOUR API key HERE> trong ví dụ trên bằng khóa API thực tế của bạn.
6. 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

Chỉ cần nhập truy vấn của bạn về IP trong cuộc trò chuyện trong Claude Desktop. Một số truy vấn ví dụ sẽ là:

• Vị trí của (IP) ở đâu?
• (IP) nằm ở đâu?
• Tọa độ của (IP) là gì?

Ví dụ, dưới đây là kết quả của 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.

Bạn cũng có thể sử dụng API Định vị Địa lý Hàng loạt IP2Location.io để truy vấn nhiều địa chỉ IP. Chỉ cần nhập tất cả các địa chỉ IP với khoảng trắng giữa mỗi địa chỉ IP. Ví dụ 8.8.8.8 8.8.6.6.

[!LƯU Ý]
API Định vị Địa lý Hàng loạt IP2Location.io yêu cầu gói trả phí để hoạt động.

Biến Môi trường

IP2LOCATION_API_KEY

Khóa API IP2Location.io, cho phép bạn truy vấn tối đa 50.000 mỗi tháng và biết thêm chi tiết về địa chỉ IP. Bạn có thể đăng ký khóa API miễn phí, hoặc đăng ký gói để tận hưởng nhiều lợi ích hơn.

Công cụ

get_geolocation

Mô tả Tìm nạp định vị địa lý cho địa chỉ IP đã cho hoặc một lô địa chỉ IP. Nó giúp người dùng truy xuất thông tin chi tiết như quốc gia, khu vực, 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): Địa chỉ IP (IPv4 hoặc IPv6) cần phân tích. Bạn có thể truy vấn nhiều IP cùng lúc bằng cách truyền chúng dưới dạng một chuỗi duy nhất được phân tách bằng dấu phẩy, khoảng trắng hoặc dòng mới (ví dụ: "1.1.1.1, 2.2.2.2").

Trả về Một chuỗi JSON chứa dữ liệu định vị địa lý. Nếu nhiều IP được truy vấn, nó trả về một đối tượng JSON trong đó mỗi khóa là một địa chỉ IP được ánh xạ tới dữ liệu tương ứng của nó. Kết quả có thể bao gồm các trường sau, tùy thuộc vào gói API của bạn:

• Vị trí & Địa lý: Quốc gia, khu vực, quận, thành phố, mã ZIP, vĩ độ & kinh độ, múi giờ.
• Mạng & Kết nối: ASN (Số Hệ thống Tự trị), ISP (Nhà cung cấp Dịch vụ Internet), tên miền, tốc độ mạng, mã IDD, mã vùng, loại địa chỉ, loại sử dụng.
• Thông tin Di động: MNC (Mã Mạng Di động), MCC (Mã Quốc gia Di động), Thương hiệu Di động.
• Tiền tệ & Ngôn ngữ: mã tiền tệ, tên tiền tệ, ký hiệu tiền tệ, mã ngôn ngữ, tên ngôn ngữ.
• Proxy & Bảo mật: loại proxy, lần cuối thấy, mức độ/loại đe dọa, nhà cung cấp proxy, điểm gian lận.
• Khác: Danh mục IAB, thời tiết, độ cao, dân số và hơn thế nữa.

Nếu một yêu cầu IP đơn lẻ thất bại hoặc IP không hợp lệ, công cụ sẽ 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ạ tới địa chỉ IP cụ thể đó mà không làm thất bại toàn bộ lô.

Giấy phép

Xem tệp LICENSE.