What is Whereami Mcp

WhereAmI MCP is a lightweight server that provides precise location information based on the user’s current IP address, utilizing the ipapi.co service.

Use cases

Use cases include providing location-based services, generating location reports for analytics, and enhancing user experience by displaying local content based on geographic location.

How to use

To use WhereAmI MCP, clone the repository, install the required dependencies, and run the server using Python. You can also install it as an MCP service for easier access.

Key features

Key features include dynamic resource fetching for specific location data, a detailed location report generator, natural language prompts for user queries, robust error handling, and minimal dependencies.

Where to use

WhereAmI MCP can be used in various fields such as web applications, mobile apps, and any service requiring geolocation data based on IP addresses.

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 and httpx.

Installation

Prerequisites

• Python 3.10+
• pip

Setup

1. Clone the repository:

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

2. Install dependencies:

   pip install mcp httpx
   

3. (Optional) Install as an MCP service:

   mcp install whereami_mcp.py --name "WhereAmI"
   

Usage

Running the Server

• Direct execution:

  python whereami_mcp.py
  

• Development 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

1. Install the server:

   mcp install whereami_mcp.py --name "WhereAmI"
   

2. Query data:
   • “My IP is @location://ip”
   • “I’m in @location://city, @location://country”
3. Get full report:
   • “Where am I?”
   • get_location()

License

MIT License. See LICENSE for details.