WhereAmI MCP 服务器

一个轻量级的 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
• 示例输出:

  | 字段          | 值             |
  |----------------|-------------------|
  | 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()

许可证

MIT 许可证。 详情请参阅 LICENSE。