WhereAmI MCP Server logo

WhereAmI MCP Server

by kukapay

WhereAmI MCP Server is a lightweight server that determines your location based on your IP address using the ipapi.co service. It provides dynamic resources and a detailed tool for geolocation data.

View on GitHub

Last updated: N/A

What is WhereAmI MCP Server?

WhereAmI MCP Server is a server that uses the ipapi.co API to provide geolocation information based on the user's IP address. It offers dynamic resources to fetch specific data and a tool to generate a comprehensive location report.

How to use WhereAmI MCP Server?

To use the server, first install it using pip install mcp httpx. Then, you can run it directly with python whereami_mcp.py or in development mode with mcp dev whereami_mcp.py. You can query specific data using the location://{type} resource, generate a full report with get_location(), or use the natural language prompt 'Where am I?'

Key features of WhereAmI MCP Server

  • Dynamic Resources (location://{type})

  • Detailed Location Report (get_location())

  • Natural Language Prompt (Where am I?)

  • Robust Error Handling

  • Minimal Dependencies

Use cases of WhereAmI MCP Server

  • Determining user location for personalized content

  • Displaying location information in applications

  • Geographic data analysis

  • Testing and debugging location-based services

FAQ from WhereAmI MCP Server

What is the data source for location information?

The server uses the ipapi.co API to retrieve geolocation data.

What types of location data can I retrieve?

You can retrieve IP address, country, country code, region, city, latitude, longitude, timezone, ISP, and ASN.

How do I install the server as an MCP service?

Use the command mcp install whereami_mcp.py --name "WhereAmI".

What are the dependencies for this server?

The server requires mcp and httpx.

Can I use this server in Claude Desktop?

Yes, you can install the server and query data using prompts like 'My IP is @location://ip' or 'Where am I?'