Whereami MCP

A lightweight geographical location query MCP service based on IP addresses, providing detailed IP location information.

Location services Developer tools #IP location #Geographical query #MCP service .Python

rating : 2.5 points

downloads : 6.9K

update time : 2025-04-29

Open Site

What is the WhereAmI MCP Server?

The WhereAmI MCP Server is a simple and easy - to - use tool that can provide you with detailed geographical location information based on your current IP address. For example, it can tell you the country, city, latitude, longitude, and Internet Service Provider (ISP) you are in.

How to use the WhereAmI MCP Server?

Simply start the server and enter simple commands to get your location information. You can directly ask 'Where am I?' or use specific resource commands to get more detailed geographical location information.

Applicable scenarios

It is suitable for scenarios where you need to quickly know your geographical location, such as when travelers need to know the city they are in, or when developers need to check the IP address when debugging network connections.

Main features

Dynamic resources

Supports getting specific types of geographical location data through commands such as `@location://ip` or `@location://city`.

Comprehensive report generation

Generates a detailed report containing multiple geographical information fields through `get_location()`.

Natural language prompt

Supports using natural language questions, such as 'Where am I?', to get detailed location information.

Powerful error handling

When encountering API or network problems, the system will handle them gracefully and give corresponding prompts.

Minimal dependencies

Only depends on two lightweight libraries, `mcp` and `httpx`.

Advantages

Lightweight design, easy to install and use.

Supports multiple query methods to meet different needs.

Has good fault - tolerance for API and network problems.

Only depends on a small number of external libraries, reducing system overhead.

Limitations

Requires an Internet connection to work.

Depends on a third - party API (ipapi.co), which may be affected by its limitations.

May require a certain technical background for some advanced functions.

How to use

Install the WhereAmI MCP Server

First, make sure your system has Python 3.10 or a higher version installed. Then install the required dependency libraries through pip.

Start the server

Run the following command to start the server: python whereami_mcp.py or mcp dev whereami_mcp.py.

Use commands to query location information

Enter commands such as `@location://city` or `get_location()` to get your location information.

Usage examples

Query the IP address

Enter `@location://ip` to get your public IP address.

Get a complete location report

Enter `get_location()` to view detailed geographical location information.

Natural language query

Enter 'Where am I?' to get the current location information.

Frequently Asked Questions

How to install the WhereAmI MCP Server?

What should I do if I encounter an API problem?

What types of queries are supported?

Related resources

Official documentation

The GitHub repository of the WhereAmI MCP Server.

ipapi.co API documentation

Documentation of the third - party API for getting geographical location information.

🚀 WhereAmI MCP Server

A lightweight MCP server that tells you your exact location based on your current IP address, powered by ipapi.co.

🚀 Quick Start

The WhereAmI MCP Server is a handy tool for getting location information from your IP address. It offers various ways to access location data with minimal dependencies.

✨ Features

Dynamic Resources: Fetch specific data (e.g., IP, country, city) via location://{type}.
Detailed Tools: Generate a comprehensive location report using get_location().
Natural Language Prompts: Ask "Where am I?" to get detailed results.
Robust Error Handling: Gracefully handle API and network issues.
Minimal Dependencies: Only requires mcp and httpx.

📦 Installation

Prerequisites

Python 3.10+
pip

Setup

Clone the repository:

git clone https://github.com/kukapay/whereami-mcp.git
cd whereami-mcp

Install the dependencies:
```
pip install mcp httpx
```

(Optional) Install as an MCP service:

mcp install whereami_mcp.py --name "WhereAmI"

💻 Usage Examples

Running the Server

Run directly:
```
python whereami_mcp.py
```
Run in development mode:
```
mcp dev whereami_mcp.py
```

Components

Resources: `location://{type}`

Returns specific location information 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"

Tools: `get_location()`

Generates detailed geographical location data in a Markdown table format.

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           |

Prompts: `where_am_i_prompt`

Pre - defined query: "Please tell me my location based on my current IP address." Triggers get_location().

Example in Claude Desktop

Install the server:

mcp install whereami_mcp.py --name "WhereAmI"

Query data:
- "My IP is @location://ip"
- "I am located in @location://city, @location://country"
Get a full report:
- "Where am I?"
- get_location()