IP Location MCP

IP Location MCP

中国語で出力するIPv4位置情報検索 — 国／地域／都市、座標、タイムゾーン、ISP／ASN 情報を取得します。2つの無料プロバイダー間で自動的にフォールバックします。

• 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（月10,000リクエストまで無料）。英語から中国語への国／省マッピングを内蔵しています（中国の全省、および米国／オーストラリア／日本／韓国の一般的な地域に対応）。
• 結果は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をすべて中国語で出力します。主系統と予備系統の2経路により高可用性を実現します。

オンライン接続先（無料、キー不要、すぐに使用可能）：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キーやアカウントは一切不要です。

📄 ライセンス

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 クライアント）が、1 つの URL を通じて MCP ツールを検出し、利用できます。

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

一度追加するだけで、あとは自然な言葉で話しかければ、AI が適切な MCP を自動で検索 → 調査 → 呼び出しします。

• 🔍 インデックス済みの MCP サーバー 22,000 件以上を横断検索（中国語・英語）
• ⚡ 50 以上の稼働中 MCPをすぐに直接呼び出し可能（天気、為替レート、注目トレンド、IP ジオロケーション、列車のチケットなど）
• 📦 GitHub ベースの MCP：検索で見つけ、ローカルにインストールするためのリンクを確認できます
• ✅ サーバーの稼働状況を毎週チェックし、稼働中のサーバーを優先表示します
• 🆓 無料で利用でき、キーは不要です

📖 3 ステップのセットアップガイド / 中国語の接続チュートリアル: https://mcp.pianam.cn/ai-gateway