Whereami MCP

🚀 WhereAmI MCP サーバー

軽量級のMCPサーバーで、あなたの現在のIPアドレスから正確な位置を教えてくれます。ipapi.coによってサポートされています。

🚀 クイックスタート

このサーバーは、あなたのIPアドレスを元に正確な位置情報を提供します。以下のセクションでは、インストール方法や使用方法を説明します。

✨ 主な機能

• 動的リソース：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
• 出力例：

  | フィールド       | 値                |
  |------------------|-------------------|
  | IP               | 8.8.8.8           |
  | 国               | United States     |
  | 国コード         | US                |
  | 地域             | California        |
  | 都市             | Mountain View     |
  | 緯度             | 37.4223           |
  | 経度             | -122.0848         |
  | タイムゾーン     | 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()