WhereAmI MCP Server
A lightweight mcp server that tells you exactly where you are based on your current IP, powered by ipapi.co.
Features
Dynamic Resources: Fetch specific data (e.g., IP, country, city) via
location://{type}.Detailed Tool: Generate a comprehensive location report with
get_location().Natural Language Prompt: Ask "Where am I?" to get detailed results.
Robust Error Handling: Gracefully manages API and network issues.
Minimal Dependencies: Requires only
mcpandhttpx.
Installation
Prerequisites
Python 3.10+
pip
Setup
Clone the repository:
git clone https://github.com/kukapay/whereami-mcp.git cd whereami-mcpInstall dependencies:
pip install mcp httpx(Optional) Install as an MCP service:
mcp install whereami_mcp.py --name "WhereAmI"
Usage
Running the Server
Direct execution:
python whereami_mcp.pyDevelopment mode:
mcp dev whereami_mcp.py
Components
Resource: location://{type}
Returns a specific location detail based on {type}.
Supported Types:
ip,country,country_code,region,city,latitude,longitude,timezone,isp,asnExamples:
@location://ip→"8.8.8.8"@location://city→"Mountain View"@location://country→"United States"
Tool: get_location()
Generates a detailed Markdown table of geolocation data.
Fields:
IP
Country
Country Code
Region
City
Latitude
Longitude
Timezone
ISP
ASN
Sample Output:
| Field | Value | |----------------|-------------------| | IP | 8.8.8.8 | | Country | United States | | Country Code | US | | Region | California | | City | Mountain View | | Latitude | 37.4223 | | Longitude | -122.0848 | | Timezone | America/Los_Angeles | | ISP | GOOGLE | | ASN | AS15169 |
Prompt: where_am_i_prompt
Predefined query: "Please tell me where I am based on my current IP address." Triggers get_location().
Examples in Claude Desktop
Install the server:
mcp install whereami_mcp.py --name "WhereAmI"Query data:
"My IP is
@location://ip""I’m in
@location://city,@location://country"
Get full report:
"Where am I?"
get_location()
License
MIT License. See LICENSE for details.
This server cannot be installed
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
A lightweight mcp server that tells you exactly where you are.
Related Resources
Related MCP Servers
- Asecurity-licenseAqualityA lightweight MCP server that tells you exactly who you are.Last updated -11MIT License
- -security-license-qualityAn MCP server for nearby place searches with IP-based location detection.Last updated -17MIT License
- -security-license-qualityA lightweight gateway server that provides a unified connection entry point for accessing multiple MCP servers, supporting various protocols including Network and Local Transports.Last updated -Apache 2.0
- -security-license-qualityA MCP server that uses Amap API to provide location-based services, allowing users to get geographic information based on IP addresses and search for nearby points of interest.Last updated -13