IP Location MCP

cn.pianam.mcpPublished by mcp.pianam.cnOfficial publisherv1.0.0Updated Oct 24, 2026

MCP server for IPv4 geolocation with Chinese output: country/region/city, ISP and ASN.

The publisher's own server: China 12306 Train Tickets MCP

VerifiedStreamable HTTPWeb executableLocation & LifestyleWeb Search & Scraping

Overview

AI-generated overview

A remote MCP server that looks up IPv4 geolocation — country, region, city, coordinates, timezone, ISP and ASN — with Chinese-language output.

What you can do
Look up the geolocation of a given IPv4 address, returning country, region, city, coordinates, timezone, ISP, organization and AS number in Chinese, with an error message for invalid or non-IPv4 input. Leave the address empty to attempt a lookup of the caller's own public IP. Results are cached for 24 hours and fall back automatically between two free data providers.
When to use it
Useful when an assistant needs to resolve where an IPv4 address is located, for example to enrich logs, check whether an address is domestic or foreign, or identify the ISP behind it, and Chinese-language place names are wanted.
Requirements
Nothing to install: connect to the hosted Streamable HTTP endpoint, no authentication, API key or account required. Self-hosting is optional and needs Python with the mcp, uvicorn and starlette packages, or Docker; the server then listens locally and can be configured with MCP_HOST, MCP_PORT, MCP_ALLOWED_HOSTS and MCP_ALLOWED_ORIGINS. Network access to the upstream geolocation providers is needed.
Before you install
Lookups are read-only, but the queried IP addresses are sent to third-party geolocation providers (ip-api.com, with ipwho.is as fallback), so avoid submitting addresses you consider sensitive. When the address is left empty, the caller's own public IP is derived from the X-Forwarded-For header. The hosted endpoint is rate-limited to 200 requests per minute per IP.

Installation

In SourceWeft

  1. Open IP Location MCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/cn.pianam.mcp%2Fip-location-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

README

IP Location MCP

[License: MIT] [MCP] [Remote]

IPv4 geolocation lookup with Chinese output — country/region/city, coordinates, timezone and ISP/ASN info, with automatic fallback between two free providers.

  • Try it in 30 seconds: a free public MCP endpoint is already running — just paste the URL into your MCP client (no install, no API key).
  • Or self-host: a single Python file, stdlib HTTP + FastMCP, zero paid dependencies.

⚡ Use the hosted endpoint (no setup)

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

Transport: Streamable HTTP (MCP 2025-03-26 compatible). No authentication required.

🔌 Client configuration

Add this to your MCP client's mcpServers configuration (Claude Desktop claude_desktop_config.json, Cursor mcp.json, Cline, Cherry Studio, etc.):

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

Clients that do not accept "type": "http" (some Cherry Studio / older Cline versions) accept the same entry with just "url".

🧰 Tools

ToolParametersReturns
query_ip_location(ip="", ctx=None)ip: IPv4 address, e.g. "8.8.8.8". Empty: attempts the caller's own public IP (via X-Forwarded-For).归属地 (country/region/city), coordinates, timezone, ISP, organization and AS number — in Chinese. Error message for invalid/non-IPv4 input.

📡 Data sources, caching & limits

  • Primary source: ip-api.com — free endpoint with direct Chinese-language output.
  • Automatic fallback: ipwho.is (free, 10k requests/month) with built-in English→Chinese country/province mapping (all Chinese provinces + US/AU/JP/KR common regions).
  • Results cached for 24 hours (geolocation barely changes); hosted endpoint rate-limited to 200 requests / minute / IP.
  • No API key, no login; read-only lookups.

🐢 Self-hosting

bash
git clone https://github.com/boy-373/ip-location-mcp.gitcd ip-location-mcppip install -r requirements.txtpython 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"

Then point your MCP client at http://127.0.0.1:8006/mcp. No API keys or accounts are ever required.

🐳 Self-host with Docker

Option A — pull the pre-built image (fastest, no build):

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

Option B — build from source:

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

Then point your MCP client at http://127.0.0.1:8000/mcp. The container listens on 0.0.0.0:8000 by default (override with -e MCP_PORT=9000 and adjust -p accordingly). No API keys or accounts required.

🗂️ Files

  • ip_lookup_mcp_server.py — the MCP server (FastMCP, Streamable HTTP transport).
  • rate_limit.py — lightweight per-IP sliding-window rate-limit middleware (200 req/min default).
  • requirements.txt — mcp, uvicorn, starlette.
  • server.json — official MCP Registry manifest (remote server entry, ready to publish with mcp-publisher).
  • smithery.yaml / glama.json — directory listing metadata.

🇨🇳 中文使用说明

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

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

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

json
{  "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 次/分钟。

本地部署：

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

Docker 自托管：

bash
# 方式一：直接拉预构建镜像（最快，无需构建）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-mcpdocker 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 或账号。

📄 License

MIT © 2026 boy-373

Install via Smithery

One-click install for Smithery-supported clients (Claude Desktop, Cursor, etc.):

[Smithery]

Or run:

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

🔌 Use with Any AI Client — One-Click MCP Gateway

We host a free MCP aggregation gateway: your AI assistant (Cherry Studio, Claude Desktop, Cursor, Cline — any MCP client) discovers and uses MCP tools through a single URL:

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

Add it once, then talk in plain language — the AI automatically searches → inspects → calls the right MCP for you.

  • 🔍 Search across 22,000+ indexed MCP servers (Chinese & English)
  • ⚡ 50+ live hosted MCPs callable directly out of the box (weather, exchange rates, hot trends, IP geo, train tickets…)
  • 📦 GitHub-based MCPs: search finds them with links to install locally
  • ✅ Servers health-checked weekly — alive ones ranked first
  • 🆓 Free to use, no key required

📖 3-step setup guide / 中文接入教程: https://mcp.pianam.cn/ai-gateway

Source: README.md at commit db8eb90

Tools

0
SourceWeft has not read this server's tools yet.

Version history

1
  1. v1.0.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declaredRequired10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts

Other Pianam integrations

China 12306 Train Tickets MCP

cn.pianam.mcpOfficial publisher

A read-only MCP server that lets an assistant look up China Railway 12306 train schedules and remaining seat availability by Chinese station name and date.

Streamable HTTPWeb executable
Location & LifestyleNot indexed yetOct 24, 2026

Weather Forecast MCP

cn.pianam.mcpOfficial publisher

Remote MCP server that lets an assistant look up current weather and up to 7-day forecasts for cities worldwide, with Chinese city names and Chinese output.

Streamable HTTPWeb executable
Location & LifestyleNot indexed yetNov 2, 2026

Stock Mcp

cn.pianam.mcpOfficial publisher

A remote MCP server that gives an assistant real-time China A-share stock quotes and the three major market indices, with dual-source fallback.

Streamable HTTPWeb executable
FinanceNot indexed yetOct 24, 2026

MCP Aggregation Gateway — 22k+ MCP search & call

cn.pianam.mcpOfficial publisher

A remote MCP gateway that lets an assistant search a catalog of 22k+ MCP servers and call 50+ hosted tools without an API key.

Streamable HTTPWeb executable
Developer ToolsNot indexed yetOct 24, 2026

China Hot Trending MCP

cn.pianam.mcpOfficial publisher

A remote MCP server that fetches real-time hot-search and trending boards from eight Chinese platforms, such as Weibo, Zhihu and Bilibili, in one call.

Streamable HTTPWeb executable
Web Search & ScrapingNot indexed yetOct 24, 2026