ip-info-mcp

Servidor de consulta de información de direcciones IP basado en el protocolo MCP (Model Context Protocol), que se comunica con los clientes de IA a través de la capa de transporte stdio.

Funciones

• Consultar IP local — Obtiene la IP pública actual e información de ubicación

• Consultar IP específica — Consulta la ubicación, ISP, latitud y longitud, etc. de cualquier dirección IP

• Consulta integral — Admite IPv4/IPv6, incluye nombre de host, organización, código postal, zona horaria, etc.

Related MCP server: personal-mcp-server

Mecanismo de comunicación MCP stdio

Este proyecto utiliza la capa de transporte stdio del protocolo MCP:

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

• El cliente envía solicitudes JSON-RPC a través de stdin (por ejemplo, tools/call)

• El servidor devuelve respuestas JSON-RPC a través de stdout

• stderr se utiliza para la salida de registros y no afecta al protocolo de comunicación

• No requiere servicio HTTP, arranca de forma ligera y es adecuado para la integración de herramientas locales

Inicio rápido

1. Instalar dependencias

pip install -r requirements.txt

2. Configurar en el cliente de IA

En CodeBuddy, añade en Settings → MCP → Add MCP:

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

3. Uso

Una vez configurado, pregunta directamente en la conversación:

• "¿Cuál es mi IP pública?"

• "Consulta la ubicación de 8.8.8.8"

• "Consulta la información de esta IP: 114.114.114.114"

Estructura del proyecto

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

Stack tecnológico

• MCP Python SDK — Implementación del protocolo MCP

• httpx — Cliente HTTP asíncrono

• ip-api.com / ipinfo.io — API gratuita de consulta de IP

Licencia

MIT