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 表。

• 字段：

  • 知识产权

  • 国家

  • 国家/地区代码

  • 地区

  • 城市

  • 纬度

  • 经度

  • 时区

  • 互联网服务提供商

  • 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 许可证。详情请参阅许可证。