WhereAmI MCPサーバー

ipapi.coが提供する、現在の IP アドレスに基づいて現在位置を正確に知らせてくれる軽量の MCP サーバーです。

特徴

• 動的リソース: location://{type}経由で特定のデータ (IP、国、都市など) を取得します。

• 詳細ツール: get_location()を使用して包括的な位置レポートを生成します。

• 自然言語プロンプト: 「私はどこにいる?」と尋ねると、詳細な結果が表示されます。

• 堅牢なエラー処理: 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. 完全なレポートを入手する:

   • 「ここはどこ？」

   • get_location()

ライセンス

MITライセンス。詳細はライセンスを参照してください。