📌Overview

Purpose: To provide a simple server for obtaining detailed geolocation information about IP addresses using the IPInfo API.

Overview: The IP Geolocation MCP Server leverages the Model Context Protocol to interface with the IPInfo service, allowing users to retrieve approximate location and network details based on a given IP address. This functionality is primarily intended to enhance applications that require geolocation data to improve user experience or analytics.

Key Features:

• IP Detail Retrieval: Utilizes the get_ip_details tool to fetch comprehensive information about an IP address, which includes its location, organization, and country, thus enabling applications to accurately gauge user location.

• Easy Integration: The server can be seamlessly integrated with applications such as Claude desktop by simply adding configuration settings in JSON format, making it accessible for developers to implement in their projects.

---

IP Geolocation MCP Server

This is a simple Model Context Protocol server that uses the ipinfo.io API to get detailed information about an IP address. This can be used to determine approximately where the user is located and the network they are using.

Installation

You'll need to create a token to use the IPInfo API.
If you don't already have one, sign up for a free account at https://ipinfo.io/signup.

To use with Claude desktop, add the following to the mcpServers section of your claude_desktop_config.json file:

    "ipinfo": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/briandconnelly/mcp-server-ipinfo.git",
        "mcp-server-ipinfo"
      ],
      "env": {
        "IPINFO_API_TOKEN": "<YOUR TOKEN HERE>"
      }
    }

Components

Tools

• get_ip_details: This tool retrieves detailed information about an IP address.
  • Input: ip — The IP address to get information about.
  • Output: IPDetails — A Pydantic model containing detailed information about the IP, including location, organization, and country details.

Resources

No custom resources are included

Prompts

No custom prompts are included

License

MIT License - See LICENSE file for details.

Disclaimer

This project is not affiliated with IPInfo.