kukapay/whereami-mcp logo

kukapay/whereami-mcp

Free

基于当前 IP 精确告知您所在位置的轻量级 MCP 服务器。

FreeFree tier
Type
Open Source

About kukapay/whereami-mcp

WhereAmI MCP Server is a lightweight Model Context Protocol (MCP) server that determines your geographic location based on your current IP address. It leverages the ipapi.co API to provide accurate geolocation data including country, city, region, latitude, longitude, timezone, ISP, and ASN. The server offers a dynamic resource (location://{type}) for fetching individual location fields, a comprehensive tool (get_location()) that returns a full location report as a Markdown table, and a natural language prompt ("Where am I?") to trigger the tool. With minimal dependencies (only mcp and httpx), it is designed for easy integration into MCP-enabled environments like Claude Desktop, providing a simple way to add IP-based geolocation awareness.

Key Features

Dynamic Resources: Fetch specific location data (e.g., IP, country, city) via location://{type}
Detailed Tool: Generate a comprehensive location report with get_location() returning a Markdown table
Natural Language Prompt: Ask 'Where am I?' to trigger a full location report
Robust Error Handling: Gracefully manages API and network issues
Minimal Dependencies: Requires only mcp and httpx for easy installation

Pros & Cons

Pros
  • Lightweight and minimal dependencies (mcp, httpx)
  • Easy to install and run (single Python file or mcp install)
  • Provides both resource and tool endpoints for flexible access
  • Uses ipapi.co for reliable, accurate geolocation data
  • Open source under MIT license, free to use and modify
Cons
  • Relies on an external API (ipapi.co) which may have rate limits or require a paid plan for high-volume usage
  • Location accuracy is limited to IP-based geolocation (not GPS), which can be imprecise for VPNs, proxies, or mobile networks
  • No built-in caching mechanism for repeated queries

Best For

Determine a user's approximate geographic location from their IP addressEnhance MCP-based applications with location contextGenerate location reports for analytics or personalizationIntegrate IP geolocation into conversational AI assistants like Claude Desktop