WhereAmI MCP Server
2025.03.28
2
Python位置服务位置服务
WhereAmI MCP Server 是一个轻量级的 MCP 服务，基于用户的当前 IP 地址提供精确的位置信息。它通过 ipapi.co 提供的数据，支持动态资源获取、详细位置报告生成以及自然语言查询等功能。
View on GitHub
Overview
基本能力
产品定位
WhereAmI MCP Server 是一个轻量级的 MCP 服务，旨在通过用户的当前 IP 地址提供精确的位置信息。
核心功能
- 动态资源获取：通过
location://{type}获取特定类型的位置数据（如 IP、国家、城市等）。 - 详细位置报告：使用
get_location()生成包含 IP、国家、城市、经纬度等详细信息的 Markdown 表格。 - 自然语言查询：支持通过自然语言提问（如“Where am I?”）获取详细位置信息。
- 健壮的错误处理：优雅地处理 API 和网络问题。
- 最小依赖：仅需
mcp和httpx两个依赖。
适用场景
- 需要快速获取当前 IP 地址及其地理位置信息的应用。
- 开发者在调试或测试时需要模拟不同地理位置的应用场景。
- 需要集成地理位置服务的自动化工具或脚本。
工具列表
- Resource:
location://{type}：返回特定类型的位置信息，支持ip、country、city、latitude、longitude等。 - Tool:
get_location()：生成包含所有位置详细信息的 Markdown 表格。 - Prompt:
where_am_i_prompt：预定义的查询，触发get_location()生成详细报告。
常见问题解答
- API 或网络问题：服务会优雅地处理这些问题，确保用户体验不受影响。
使用教程
使用依赖
- Python 3.10+
pip
安装教程
- 克隆仓库：
bash git clone https://github.com/kukapay/whereami-mcp.git cd whereami-mcp - 安装依赖：
bash pip install mcp httpx - （可选）安装为 MCP 服务：
bash mcp install whereami_mcp.py --name "WhereAmI"
调试方式
- 直接运行：
bash python whereami_mcp.py - 开发模式：
bash mcp dev whereami_mcp.py
示例
- 安装服务：
bash mcp install whereami_mcp.py --name "WhereAmI" - 查询数据：
- "My IP is
@location://ip" - "I’m in
@location://city,@location://country" - 获取完整报告：
- "Where am I?"
get_location()