A transparent, ethical, and modular location-sharing ecosystem designed for family safety and child protection.
- Android Client: A lightweight, foreground-service-based tracking application that sends GPS data to a central server.
- MCP Server: A Model Context Protocol server that provides an AI-driven interface for querying and managing tracking data using natural language.
- Transparent Tracking: Persistent notifications ensure the user always knows their location is being shared.
- Guided Setup: An intuitive initial flow to help users configure the app correctly.
- AI-Powered Interface: Talk to your tracking data via LLMs like Claude or Gemini instead of using complex dashboards.
- Modular Architecture: Separate client and server modules for lean deployment and scalability.
- Child Safety: Knowing when your child arrives at school or returns home.
- Family Sharing: Coordinating locations during outings or travel.
- Elderly Care: Ensuring vulnerable family members are safe and within expected areas.
You need a tracking server instance (e.g., Traccar).
- Note the Server URL and your credentials.
- Build the APK from the
android-clientdirectory. - Install it on the family member's device.
- Follow the guided setup to enter your Server URL and grant permissions.
- Deploy the
mcp-serveron a Python-capable host. - Configure
mcp_config.jsonwith your server API details. - Connect your preferred LLM to the MCP server.
- See AI_INTEGRATION.md for example prompts.
This project is built on the principles of informed consent and transparency.
- Unauthorized tracking is strictly prohibited and often illegal.
- The application must never be hidden or its purpose masked.
- For detailed deployment rules, see DEPLOYMENT.md.
See ARCHITECTURE.md for system diagrams and technical details.