whereami-mcp

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ライセンス。詳細はライセンスを参照してください。