Content
# 💜 LoverConnect
> A Android MCP tool app designed for companion AI～
> Let your AI companion "perceive" your phone status and truly accompany you 🐾
---
## ✨ What is this?
LoverConnect (LC for short) is a small tool that runs in the background of your phone, exposing your phone status to AI chat platforms (like RikkaHub) through the MCP protocol.
In simple terms: with it, your AI can know your phone battery level, how many steps you took today, what app you're using, and the weather outside... just like a person who truly cares about you 💕
---
## 🛠️ Tool List
| Tool Name | What it can do |
|--------|----------|
| `get_battery` | 📱 Check phone battery level and charging status |
| `get_screen_time` | ⏰ Check 24-hour rolling screen time |
| `get_app_timeline` | 📊 Complete 24-hour app usage timeline |
| `get_steps` | 🚶 Today's step count |
| `get_weather` | 🌤️ Check the weather in your city |
| `get_anniversary` | 💍 Anniversary reminder |
| `send_notification` | 🔔 AI sends notifications/pop-ups to you |
| `save_memory` | 💾 Store memories |
| `read_memory` | 📖 Read memories |
| `reset_screen_time` | 🔄 Reset screen time statistics |
---
## 📦 Installation and Usage
### 1. Install the App
Download the latest APK and install it on your phone～
### 2. Authorize Permissions
After opening the app, click on the permission buttons to complete authorization:
- Usage access permission
- Battery optimization whitelist
- Notification permission
- Physical activity permission
- Self-start management
### 3. Connect to Your AI Platform
LC will start a local MCP service with the address:
http://127.0.0.1:5000/mcp
Add an MCP connection in your chat platform (like RikkaHub) and fill in the above address～
---
## ⚠️ Precautions
- **Background survival**: Domestic phones (OPPO, vivo, Xiaomi, etc.) need to manually set up background running and close battery optimization, or the app will be killed by the system and disconnected
- **OPPO users**: It is recommended to set up "allow full background behavior", or hang a small window (very low probability), or the MCP connection will be disconnected
- **Weather function**: You need to set your city name in the app
- **Anniversary**: Manually add your important days in the app～
---
## 🏗️ Technology Stack
- Kotlin + Jetpack Compose
- compileSdk 36
- MCP Streamable HTTP (port 5000)
- Weather data source: wttr.in
---
## 💬 Communication
Have questions, suggestions, or want to play together? Welcome to the group chat～
---
## 💜 Finally
The original intention of this project is simple - let AI not just be a text in the chat box, but truly "perceive your existence".
Hope it can accompany you too 🐾
