WhereAmI MCP Server

WhereAmI MCP Server

ipapi.co を利用して、現在の IP アドレスに基づき、現在地を正確に知らせる軽量な MCP サーバーです。

機能

• 動的リソース：location://{type} を使って、IP、国、都市などの特定のデータを取得します。
• 詳細なツール：get_location() を使って、包括的な位置情報レポートを生成します。
• 自然言語プロンプト：「Where am I?」と尋ねると、詳細な結果を取得できます。
• 堅牢なエラー処理：API やネットワークの問題を適切に処理します。
• 最小限の依存関係：必要なのは mcp と httpx のみです。

インストール

前提条件

• Python 3.10+
• pip

セットアップ

1. リポジトリをクローンします：

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

2. 依存関係をインストールします：

   pip install mcp httpx
   

3. （任意）MCP サービスとしてインストールします：

   mcp install whereami_mcp.py --name "WhereAmI"
   

使い方

サーバーの実行

• 直接実行：

  python whereami_mcp.py
  

• 開発モード：

  mcp dev whereami_mcp.py
  

コンポーネント

リソース：location://{type}

{type} に基づいて、特定の位置情報を返します。

• 対応するタイプ：ip、country、country_code、region、city、latitude、longitude、timezone、isp、asn
• 例：
  • @location://ip → "8.8.8.8"
  • @location://city → "Mountain View"
  • @location://country → "United States"

ツール：get_location()

位置情報データをまとめた詳細な Markdown 表を生成します。

• 項目：
  • IP
  • 国
  • 国コード
  • 地域
  • 都市
  • 緯度
  • 経度
  • タイムゾーン
  • ISP
  • ASN
• 出力例：

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

プロンプト：where_am_i_prompt

定義済みのクエリ：「現在の IP アドレスに基づいて、現在地を教えてください。」get_location() を呼び出します。

Claude Desktop での例

1. サーバーをインストールします：

   mcp install whereami_mcp.py --name "WhereAmI"
   

2. データを問い合わせます：
   • 「私の IP は @location://ip です」
   • 「私は @location://city、@location://country にいます」
3. 完全なレポートを取得します：
   • 「Where am I?」
   • get_location()

ライセンス

MIT License。詳細は LICENSE を参照してください。