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
mcp
andhttpx
.
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
,asn
Examples:
@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
- AsecurityAlicenseAqualityA lightweight MCP server that tells you exactly who you are.Last updated -11MIT License
- -securityAlicense-qualityAn MCP server for nearby place searches with IP-based location detection.Last updated -17MIT License
- -securityAlicense-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
- -securityFlicense-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