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.