WhereAmI MCP 服务器

一个轻量级的MCP服务器，通过ipapi.co根据您的当前IP地址准确告诉您所在的位置。

功能

• 动态资源：通过location://{type}获取特定数据（例如，IP、国家、城市）。
• 详细工具：使用get_location()生成全面的位置报告。
• 自然语言提示：询问“我在哪儿？”以获得详细结果。
• 强大的错误处理：优雅地管理API和网络问题。
• 最少依赖项：仅需mcp和httpx。

安装

前提条件

• Python 3.10+
• pip

设置

1. 克隆仓库：
   bash
   git clone https://github.com/kukapay/whereami-mcp.git
   cd whereami-mcp

2. 安装依赖项：
   bash
   pip install mcp httpx

3. （可选）作为MCP服务安装：
   bash
   mcp install whereami_mcp.py --name "WhereAmI"

使用

运行服务器

• 直接执行：
  bash
  python whereami_mcp.py

• 开发模式：
  bash
  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. 安装服务器：
   bash
   mcp install whereami_mcp.py --name "WhereAmI"

2. 查询数据：

   • "我的IP是@location://ip"
   • "我在@location://city，@location://country"

3. 获取完整报告：

   • "我在哪儿？"
   • get_location()

许可证

MIT许可证。详见LICENSE。