convez.ai
MCP ServerIntegração & APIsIntermediário
7mza

GeoLocation MCP Server

7mza/geolocation-mcp

Geolocalização por IP em tempo real para agentes de IA

Ver no GitHub
InicialPluginScore · de 0 a 100

Servidor MCP que fornece dados de geolocalização por IP rápidos e atualizados para LLMs. Oferece informações detalhadas como localização geográfica, ASN, detecção de VPN/Tor/datacenter e dados de conformidade GDPR. Funciona via HTTP e integra-se nativamente com Claude e outros clientes MCP.

Instalação

$npx convez-ai 7mza/geolocation-mcp

1 comando no terminal: detecta o formato do repositório (marketplace ou plugin avulso) e instala via Claude Code. Requer Node 18+ e o Claude Code instalado.

Métricas

Estrelas
0
Forks
0
Acompanhando
0
Saúde
42%
Último commit
há 1 semana
Versão
0.0.1
Issues abertas
0
Contribuidores
2

Casos de uso

  • Enriquecer dados de requisições HTTP com localização geográfica
  • Detectar atividades suspeitas (Tor, VPN, datacenters)
  • Análise de tráfego e compliance GDPR/UE em aplicações LLM
  • Lookup em lote de múltiplos IPs sem travamentos

Veredito

Ferramenta sólida e bem mantida para geolocalização de IPs em ambientes MCP. Dados atualizados automaticamente, suporta operações em lote e é fácil de containerizar — ideal para aplicações que precisam contextualizar requisições por localização geográfica ou segurança.

README

A tradução para o português deste README ainda está na fila.

GeoLocation MCP Server

Coverage

Fast and up-to-date IP geolocation data for LLMs

demo

For public IPv4 / IPv6 address:

  • Flags: isDatacenter, isTorExitNode, isVPN
  • City name, region ISO code, latitude/longitude, accuracy radius, postal code, timezone
  • Country name, ISO code, EU membership/GDPR
  • ASN number, ISP/organization name, network CIDR

MCP tools

ToolDescription
getGeoLocationDatasingle IP lookup
getGeoLocationDataBulkbatch lookup, failed IPs don't block the rest

Data sources

DataSourceRefresh
City / ASNGeoLite2 via P3TERX/GeoLite.mmdbon startup if absent
Tor exit nodesTor Projectdaily
VPN / Datacenter rangesX4BNet/lists_vpndaily

Usage

# named volume so DBs persist across restarts
docker run -p 8891:8080 -v geolocation_data:/home/nonroot/.geolocation-mcp 7mza/geolocation-mcp:latest

or with compose

services:
  geolocation-mcp:
    image: 7mza/geolocation-mcp:latest
    ports:
      - '8891:8080'
    restart: unless-stopped
    volumes:
      - geolocation_data:/home/nonroot/.geolocation-mcp
volumes:
  geolocation_data:
    name: geolocation_data

Connect your LLM:

# example for claude
claude mcp add --transport http geolocation http://localhost:8891/mcp

Test with MCP inspector:

npm i && npm run mcp
# transport: streamable
# url: http://localhost:8891/mcp

Build from source

Requires SDKMAN and nvm.

nvm use && npm i && sdk env install

JVM:

./gradlew clean ktlintFormat ktlintCheck build
./gradlew bootRun

Native:

./gradlew clean ktlintFormat ktlintCheck build -PgenerateMetadata
./gradlew buildImage
docker run -p 8891:8080 -v geolocation_data:/home/nonroot/.geolocation-mcp 7mza/geolocation-mcp:latest

License

GeoLite2 DBs are subject to the GeoLite2 EULA.

Ver o original no GitHub

Bom para

Relacionados