WhereAmI MCP Server

@kukapay

关于 WhereAmI MCP Server

A lightweight mcp server that tells you exactly where you are.

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

kukapay

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "whereami-mcp": {
      "command": "python",
      "args": [
        "whereami_mcp.py"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is WhereAmI MCP Server?

WhereAmI MCP Server is a lightweight Model Context Protocol server that tells you your geographic location based on your current IP address, powered by the ipapi.co API. It is designed for developers and Claude Desktop users who need quick, programmatic access to geolocation data.

How to use WhereAmI MCP Server?

Install Python 3.10+, clone the repository, install dependencies (mcp and httpx), then run python whereami_mcp.py directly or use mcp dev whereami_mcp.py for development. Optionally install it as an MCP service with mcp install whereami_mcp.py --name "WhereAmI". Query location data via the location://{type} resource or call the get_location() tool.

Key features of WhereAmI MCP Server

Dynamic resource location://{type} for specific fields (IP, city, etc.)
Full geolocation report via the get_location() tool
Predefined natural‑language prompt where_am_i_prompt
Robust error handling for API and network issues
Minimal dependencies: only mcp and httpx

Use cases of WhereAmI MCP Server

Retrieve your current city and country with a single resource call
Generate a detailed location table (IP, timezone, ISP, etc.)
Integrate geolocation data into Claude Desktop conversations
Debug or verify IP‑based location in automated workflows

FAQ from WhereAmI MCP Server

What data source does WhereAmI MCP Server use?

It uses the ipapi.co API to convert your public IP address into location details such as country, city, latitude, and longitude.

What are the minimal system requirements?

Python 3.10 or higher, and only two Python packages: mcp and httpx.

How does the server handle errors?

If the ipapi.co API is unreachable or returns an error, the server gracefully reports the issue instead of crashing.

Can I get only a single field (e.g., just the city)?

Yes. Use the resource URI location://city (or any supported type: ip, country, region, latitude, longitude, timezone, isp, asn).

Is there a natural language interface?

Yes. The where_am_i_prompt prompt automatically triggers get_location() when you ask "Where am I?" in a compliant host like Claude Desktop.

评论

其他分类下的更多 MCP 服务器

Servers

modelcontextprotocol

Model Context Protocol Servers

Maestro

Painless E2E Automation for Mobile and Web

Inbox Zero AI

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

Sequential Thinking

modelcontextprotocol

Model Context Protocol Servers

MCP Go 🚀

A Go implementation of the Model Context Protocol (MCP), enabling seamless integration between LLM applications and external data sources and tools.