WhereAmI MCP Server

Name: WhereAmI MCP Server
Author: kukapay

@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.

「その他」の他のコンテンツ

Reactive Resume

amruthpillai

A one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!

39.5K