WhereAmI MCP Server

WhereAmI MCP Server

一款轻量级 MCP 服务，可根据您当前的 IP 地址准确告知您的位置，由 ipapi.co 提供支持。

功能

• 动态资源：通过 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 许可证。详情请参阅 LICENSE。