IP Location MCP

IP Location MCP

IPv4 地理位置查询，中文输出 — 国家/地区/城市、坐标、时区和 ISP/ASN 信息，并可在两个免费数据源之间自动切换。

• 30 秒内即可试用：免费的公共 MCP 端点已在运行 — 只需将 URL 粘贴到 MCP 客户端中（无需安装，无需 API 密钥）。
• 也可自托管：单个 Python 文件，使用标准库 HTTP + FastMCP，无需付费依赖。

⚡ 使用托管端点（无需设置）

https://mcp.pianam.cn/ip-mcp/mcp

传输方式：Streamable HTTP（兼容 MCP 2025-03-26）。无需身份验证。

🔌 客户端配置

将以下内容添加到 MCP 客户端的 mcpServers 配置中（Claude Desktop 的 claude_desktop_config.json、Cursor 的 mcp.json、Cline、Cherry Studio 等）：

{
  "mcpServers": {
    "ip-location": {
      "type": "http",
      "url": "https://mcp.pianam.cn/ip-mcp/mcp"
    }
  }
}

不接受 "type": "http" 的客户端（部分 Cherry Studio / 较旧版本 的 Cline）只需使用相同条目中的 "url" 即可。

🧰 工具

工具	参数	返回内容
query_ip_location(ip="", ctx=None)	ip：IPv4 地址，例如 "8.8.8.8"。留空时：尝试查询调用方自己的公网 IP（通过 X-Forwarded-For）。	归属地（国家/地区/城市）、坐标、时区、ISP、组织和 AS 编号 — 中文输出。无效或非 IPv4 输入时返回错误消息。

📡 数据源、缓存与限制

• 主数据源：ip-api.com — 提供中文输出的免费端点。
• 自动备用数据源：ipwho.is（每月免费 10k 次请求），内置英语→中文国家/省份映射（涵盖所有中国省份，以及美国/澳大利亚/日本/韩国的常见地区）。
• 查询结果缓存 24 小时（地理位置很少变化）；托管端点的限流为 每个 IP 每分钟 200 次请求。
• 无需 API 密钥，无需登录；仅支持只读查询。

🐢 自托管

git clone https://github.com/boy-373/ip-location-mcp.git
cd ip-location-mcp
pip install -r requirements.txt
python ip_lookup_mcp_server.py
# the server listens on 127.0.0.1:8006 by default; override with:
#   MCP_HOST=0.0.0.0 MCP_PORT=9000 python ip_lookup_mcp_server.py
#   MCP_ALLOWED_HOSTS="your-domain.com,127.0.0.1:*"
#   MCP_ALLOWED_ORIGINS="https://your-domain.com"

然后将 MCP 客户端指向 http://127.0.0.1:8006/mcp。 始终无需 API 密钥或账号。

🐳 使用 Docker 自托管

选项 A — 拉取预构建镜像（最快，无需构建）：

docker run -d -p 8000:8000 --name ip-location-mcp ghcr.io/boy-373/ip-location-mcp:latest

选项 B — 从源代码构建：

git clone https://github.com/boy-373/ip-location-mcp.git
cd ip-location-mcp
docker build -t ip-location-mcp .
docker run -d -p 8000:8000 --name ip-location-mcp ip-location-mcp

然后将 MCP 客户端指向 http://127.0.0.1:8000/mcp。 容器默认监听 0.0.0.0:8000（可通过 -e MCP_PORT=9000 覆盖，并相应调整 -p）。无需 API 密钥或账号。

🗂️ 文件

• ip_lookup_mcp_server.py — MCP 服务（FastMCP，Streamable HTTP 传输）。
• rate_limit.py — 轻量级的按 IP 滑动窗口限流中间件（默认每分钟 200 次请求）。
• requirements.txt — mcp、uvicorn、starlette。
• server.json — 官方 MCP Registry 清单（远程服务条目，可直接使用 mcp-publisher 发布）。
• smithery.yaml / glama.json — 目录列表元数据。

---

🇨🇳 中文使用说明

一句话简介：IP 归属地查询，国家/省份/城市/运营商/ASN 全中文输出，主备双通道高可用。

在线直连地址（免费、无需 Key、开箱即用）：https://mcp.pianam.cn/ip-mcp/mcp

在 MCP 客户端（Claude Desktop / Cursor / Cherry Studio / Cline 等）的配置中添加：

{
  "mcpServers": {
    "ip-location": {
      "type": "http",
      "url": "https://mcp.pianam.cn/ip-mcp/mcp"
    }
  }
}

工具：

• query_ip_location(ip)：查询 IPv4 归属地。传入 IP 地址（如 8.8.8.8）；留空时尝试查询调用方自己的公网 IP。
• 返回国家/省份/城市、经纬度、时区、运营商、组织、AS 编号，中文输出。
• 主数据源为 ip-api.com（免费，直接输出中文），发生故障时自动切换到 ipwho.is（含中国省份拼音转中文映射）。

服务特性：所有数据源均为公开接口，无需注册或付费；服务端内存缓存，失败时自动降级/切换到备用通道；单个 IP 限流为每分钟 200 次。

本地部署：

git clone https://github.com/boy-373/ip-location-mcp.git
cd ip-location-mcp
pip install -r requirements.txt
python ip_lookup_mcp_server.py
# 默认监听 127.0.0.1:8006，可用环境变量 MCP_HOST / MCP_PORT / MCP_ALLOWED_HOSTS / MCP_ALLOWED_ORIGINS 覆盖

Docker 自托管：

# 方式一：直接拉预构建镜像（最快，无需构建）
docker run -d -p 8000:8000 --name ip-location-mcp ghcr.io/boy-373/ip-location-mcp:latest

# 方式二：从源码构建
git clone https://github.com/boy-373/ip-location-mcp.git && cd ip-location-mcp
docker build -t ip-location-mcp .
docker run -d -p 8000:8000 --name ip-location-mcp ip-location-mcp
# MCP 地址填：http://127.0.0.1:8000/mcp

容器默认监听 0.0.0.0:8000（可用 -e MCP_PORT=端口 修改），无需任何 API Key 或账号。

📄 许可证

MIT © 2026 boy-373

通过 Smithery 安装

为 Smithery 支持的客户端（Claude Desktop、Cursor 等）提供一键安装：

或运行：

npx -y @smithery/cli install 1561852680/ip-location-mcp --client claude

---

🔌 适用于任何 AI 客户端 — 一键 MCP 网关

我们托管了一个免费的 MCP 聚合网关：你的 AI 助手（Cherry Studio、Claude Desktop、Cursor、Cline — 任何 MCP 客户端）都可以通过一个 URL 发现并使用 MCP 工具：

https://mcp.pianam.cn/ai/mcp

添加一次，然后用自然语言交流 — AI 会自动为你搜索 → 检查 → 调用合适的 MCP。

• 🔍 搜索 22,000+ 个已索引的 MCP 服务（中文和英文）
• ⚡ 50+ 个在线托管的 MCP，开箱即可直接调用（天气、汇率、热门趋势、IP 地理位置、火车票……）
• 📦 基于 GitHub 的 MCP：搜索结果会提供链接，方便在本地安装
• ✅ 每周检查服务健康状态 — 正常运行的服务会优先显示
• 🆓 免费使用，无需密钥

📖 3 步设置指南 / 中文接入教程：https://mcp.pianam.cn/ai-gateway