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。 </中文翻译>