Whereami MCP

🚀 WhereAmI MCP 服務器

一個輕量級的 MCP 服務器，它能夠依據你當前的 IP 地址，精準告知你的確切位置。該服務器由 ipapi.co 提供支持。

🚀 快速開始

WhereAmI MCP 服務器是一款輕量級工具，藉助 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
• 示例輸出：

  | 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 許可證。