ip-info-mcp

MCP (Model Context Protocol) プロトコルに基づく IP アドレス情報照会サーバーで、stdio トランスポート層 を通じて AI クライアントと通信します。

機能

• 自機 IP の照会 — 現在のパブリック IP と所在地情報を取得

• 指定 IP の照会 — 任意の IP アドレスの所在地、ISP、緯度・経度などを照会

• 総合照会 — IPv4/IPv6 に対応し、ホスト名、組織、郵便番号、タイムゾーンなどを含む

Related MCP server: personal-mcp-server

MCP stdio 通信の仕組み

このプロジェクトは MCP プロトコルの stdio トランスポート層 を使用します：

┌─────────────────┐         ┌──────────────────────┐
│  AI 客户端        │  stdin  │  MCP Server (本进程)  │
│  (CodeBuddy 等)   │◄───────►│  python server.py     │
│                   │  stdout │                       │
└─────────────────┘         └──────────────────────┘

• クライアントは stdin を介して JSON-RPC リクエスト（例：tools/call）を送信します

• サーバーは stdout を介して JSON-RPC レスポンスを返します

• stderr はログ出力に使用され、通信プロトコルには影響しません

• HTTP サービスが不要で、軽量に起動でき、ローカルツールとの統合に適しています

クイックスタート

1. 依存関係のインストール

pip install -r requirements.txt

2. AI クライアントへの設定

CodeBuddy の Settings → MCP → Add MCP に追加します：

{
  "mcpServers": {
    "ip-info": {
      "type": "stdio",
      "command": "python",
      "args": ["path/to/server.py"],
      "description": "IP 地址信息查询工具"
    }
  }
}

3. 使用

設定後、そのまま会話で質問できます：

• 「自分のパブリック IP は何ですか？」

• 「8.8.8.8 の所在地を調べて」

• 「この IP の情報を調べて：114.114.114.114」

プロジェクト構成

ip-info-mcp/
├── server.py          # MCP 服务器主文件
├── requirements.txt   # Python 依赖
├── README.md          # 本文件
└── chatmcp.yaml       # chatmcp 平台配置

技術スタック

• MCP Python SDK — MCP プロトコルの実装

• httpx — 非同期 HTTP クライアント

• ip-api.com / ipinfo.io — 無料の IP 照会 API

ライセンス

MIT