mcp-ip-geolocator

mcp-ip-geolocator

0
location_services

The MCP IP Geolocation Server is an MCP server that provides IP geolocation services without requiring an API key. It supports IPv4 and IPv6, offering network and location data like ISP information and timezone.

MCP IP Geolocation Server

A Model Context Protocol (MCP) server that provides IP geolocation services via IP-API.com. Free to use, no API key required.

Features

  • Get detailed location information for any IP address
  • Network information including ISP and AS number
  • Timezone data
  • No API key or registration required
  • Clean, formatted output for Claude

Quick Start

  1. Install globally:
npm install -g mcp-ip-geolocator
  1. Run the server:
mcp-ip-geolocator

Local Development

  1. Clone the repository:
git clone https://github.com/tedlikeskix/mcp-ip-geolocator.git
cd mcp-ip-geolocator
  1. Install dependencies:
yarn install
  1. Build and run:
yarn build
yarn start

Usage with Claude

Once running, connect to the server in Claude Desktop. Example usage:

Claude, can you check the location of IP address 8.8.8.8?

Claude will use the tool to fetch and display location information.

API Response Format

The tool returns structured data including:

  • City, region, and country
  • Latitude and longitude
  • Timezone
  • ISP and organization
  • AS number

Rate Limiting

IP-API.com's free tier includes:

  • 45 requests per minute
  • IPv4 and IPv6 support
  • No API key needed

License

MIT License - feel free to use and modify!