ip-info-mcp

An IP address information query server based on the MCP (Model Context Protocol) protocol, communicating with AI clients via the stdio transport layer.

Features

• Query local IP — Get the current public IP and location info

• Query a specific IP — Look up the location, ISP, latitude/longitude, etc. of any IP address

• Comprehensive query — Supports IPv4/IPv6, including hostname, organization, postal code, timezone, etc.

Related MCP server: Netdetective MCP Server

MCP stdio Communication Mechanism

This project uses the stdio transport layer of the MCP protocol:

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

• The client sends JSON-RPC requests (e.g. tools/call) via stdin

• The server returns JSON-RPC responses via stdout

• stderr is used for log output and does not affect the communication protocol

• No HTTP service required, lightweight startup, suitable for local tool integration

Quick Start

1. Install dependencies

pip install -r requirements.txt

2. Configure in an AI client

In CodeBuddy, add it under Settings → MCP → Add MCP:

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

3. Usage

Once configured, just ask directly in the conversation:

• "What is my public IP?"

• "Look up the location of 8.8.8.8"

• "Check the info for this IP: 114.114.114.114"

Project Structure

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

Tech Stack

• MCP Python SDK — MCP protocol implementation

• httpx — Async HTTP client

• ip-api.com / ipinfo.io — Free IP lookup API

License

MIT