MCP IP Geolocation Server

View original on GitHub 

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

2. 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

2. Install dependencies:

yarn install

3. 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!