whereami-mcp

Servidor MCP WhereAmI

Un servidor mcp liviano que le indica exactamente dónde se encuentra en función de su IP actual, desarrollado por ipapi.co .

Características

• Recursos dinámicos : obtenga datos específicos (por ejemplo, IP, país, ciudad) a través de location://{type} .
• Herramienta detallada : genere un informe de ubicación completo con get_location() .
• Indicación en lenguaje natural : pregunte "¿Dónde estoy?" para obtener resultados detallados.
• Manejo robusto de errores : gestiona con elegancia los problemas de API y red.
• Dependencias mínimas : solo requiere mcp y httpx .

Instalación

Prerrequisitos

• Python 3.10+
• pip

Configuración

1. Clonar el repositorio:
   git clone https://github.com/kukapay/whereami-mcp.git cd whereami-mcp
2. Instalar dependencias:
   pip install mcp httpx
3. (Opcional) Instalar como un servicio MCP:
   mcp install whereami_mcp.py --name "WhereAmI"

Uso

Ejecución del servidor

• Ejecución directa:
  python whereami_mcp.py
• Modo de desarrollo:
  mcp dev whereami_mcp.py

Componentes

Recurso: location://{type}

Devuelve un detalle de ubicación específico basado en {type} .

• Tipos admitidos : ip , country , country_code , region , city , latitude , longitude , timezone , isp , asn
• Ejemplos :
  • @location://ip → "8.8.8.8"
  • @location://city → "Mountain View"
  • @location://country → "United States"

Herramienta: get_location()

Genera una tabla Markdown detallada de datos de geolocalización.

• Campos :
  • Propiedad intelectual
  • País
  • Código del país
  • Región
  • Ciudad
  • Latitud
  • Longitud
  • Zona horaria
  • Proveedor de servicios de Internet
  • ASN
• Salida de muestra :
  | Field | Value | |----------------|-------------------| | IP | 8.8.8.8 | | Country | United States | | Country Code | US | | Region | California | | City | Mountain View | | Latitude | 37.4223 | | Longitude | -122.0848 | | Timezone | America/Los_Angeles | | ISP | GOOGLE | | ASN | AS15169 |

Indicación: where_am_i_prompt

Consulta predefinida: «Por favor, dígame dónde estoy según mi dirección IP actual». Activa get_location() .

Ejemplos en Claude Desktop

1. Instalar el servidor:
   mcp install whereami_mcp.py --name "WhereAmI"
2. Datos de la consulta:
   • "Mi IP es @location://ip "
   • "Estoy en @location://city , @location://country "
3. Obtenga el informe completo:
   • "¿Dónde estoy?"
   • get_location()

Licencia

Licencia MIT. Consulte LICENCIA para más detalles.