Geomanic

Companheiro de rastreamento GPS com foco em privacidade. Consulte estatísticas de viagem, gerencie waypoints, acompanhe países visitados e analise distâncias e velocidades por meio de linguagem natural. Gratuito e em conformidade com a GDPR.

GitHub

Documentação

geomanic-mcp

Ponte MCP, habilidades e modelos de configuração para Geomanic — sua plataforma de rastreamento GPS.

Estrutura do repositório

skills/
  claude/         Claude Desktop skill (SKILL.md)
  openclaw/       OpenClaw skill (SKILL.md)
bridge/
  geomanic-bridge.js   Node.js MCP bridge (stdin/stdout)
  config/
    macos.json         Claude Desktop config (macOS)
    linux.json         Claude Desktop config (Linux)
    windows.json       Claude Desktop config (Windows)
    cursor/mcp.json    Cursor MCP config
    curl/              Direct URL and cURL examples
docs/                  Tool reference and troubleshooting

Início rápido

Gere uma chave de API MCP em https://geomanic.com/data (bloco de Integração MCP).
Escolha seu cliente abaixo.

OpenClaw (Skill)

Instale a partir do ClawHub:

/skills install @weltspion/geomanic
/secrets set GEOMANIC_TOKEN YOUR_MCP_KEY

Veja skills/openclaw/README.md para detalhes.

Claude Desktop (Skill)

Baixe este repositório (Code → Download ZIP) e extraia-o.
Abra skills/claude/SKILL.md em um editor de texto e substitua cada YOUR_API_KEY pela sua chave de API real.
No Claude Desktop: Settings → Skills → Add → Upload Skill e selecione o SKILL.md editado.

Alternativamente, baixe um SKILL.md pronto para uso com sua chave já incluída em geomanic.com/data.

Cursor (Bridge)

Copie bridge/config/cursor/mcp.json para as configurações MCP do seu Cursor.
Substitua <GEOMANIC_TOKEN> pela sua chave de API MCP.
Salve e reinicie o Cursor.

URL direta (qualquer cliente MCP)

Clientes que suportam servidores MCP remotos:

URL: https://geomanic.com/api/v1/mcp
Header: Authorization: Bearer YOUR_MCP_KEY

Ferramentas disponíveis

Tool	Description
`create_waypoint`	Criar um novo waypoint GPS
`update_waypoint`	Atualizar um waypoint existente pelo ID
`delete_waypoint`	Excluir um waypoint pelo ID
`get_waypoint`	Obter um único waypoint pelo ID
`list_waypoints`	Listar waypoints com intervalo de tempo, paginação, ordenação
`get_statistics`	Estatísticas agregadas: distância, velocidade, altitude, detalhamento por país
`get_date_range`	Datas mais antigas e mais recentes dos waypoints

Veja docs/functions.md para documentação detalhada de parâmetros.

Notas de segurança

Trate a chave de API MCP como uma senha.
Nunca envie chaves para o git.
Revogue e regenere chaves na página de Dados do Geomanic se comprometidas.

Desenvolvimento

A ponte é um script Node.js simples (Node 18+) com zero dependências. Nenhuma etapa de build é necessária.