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 许可证。