A powerful, modular Android application that implements a . This application enables AI assistants to safely and securely interact with Android device capabilities through a standardized protocol.
概览
A powerful, modular Android application that implements a . This application enables AI assistants to safely and securely interact with Android device capabilities through a standardized protocol. ✨ - 🔌 : Runs as an Android foreground service using Ktor - 🧩 : Pluggable tool modules for different device capabilities - 🔐 : Each tool requires explicit user permission with clear disclaimers - 🔑 : Secure connections with authentication tokens - 🎛️ : Enable/disable tools at runtime with user consent - 🤝 : Third-party apps can expose MCP tools via Content Providers - : Send SMS messages (requires permission) - : Send SMS via Intent (no permission required) - : Access camera and take photos - : Read contacts list - : Access device sensors (accelerometer, gyroscope, etc.
README
以下为原文 README 节选，完整内容请查看原文。
Android MCP Server
A powerful, modular Android application that implements a Server-Sent Events (SSE) Model Context Protocol (MCP) server. This application enables AI assistants to safely and securely interact with Android device capabilities through a standardized protocol.
Features
✨ Core Capabilities
- 🔌 SSE-Based MCP Server: Runs as an Android foreground service using Ktor
- 🧩 Modular Architecture: Pluggable tool modules for different device capabilities
- 🔐 Privacy-Focused: Each tool requires explicit user permission with clear disclaimers
- 🔑 Bearer Token Authentication: Secure connections with authentication tokens
- 🎛️ Dynamic Tool Management: Enable/disable tools at runtime with user consent
- 🤝 External Tool Support: Third-party apps can expose MCP tools via Content Providers
Built-in Tools
- 📱 SMS: Send SMS messages (requires permission)
- 📱 SMS Intent: Send SMS via Intent (no permission required)
- 📷 Camera: Access camera and take photos
- 👥 Contacts: Read contacts list
- 📡 Sensor: Access device sensors (accelerometer, gyroscope, etc.)
- 📁 Files: Browse and read files on the device (requires permission)
- 🎯 Ads: Display ads (example tool)
- 🔌 External Tools: Auto-discover and integrate tools from other apps
On-device AppFunctions (experimental)
On Android 16 and newer, Phone MCP also publishes its first-party capabilities as native Android AppFunctions. Authorized on-device agents can use these functions locally without starting the MCP server or connecting with its URL and bearer token.
- Play build: contacts, camera, location, sensor snapshots, bounded file access, and SMS drafts
- Full build: the Play functions plus direct SMS sending
- User control: the existing tool switches enable or disable access through both MCP and AppFunctions
- Permissions: Android’s Contacts, Camera, Location, Storage, Notifications, and SMS permissions still apply
- Availability: AppFunctions are experimental, and Gemini integration is currently a limited private preview; installing Phone MCP does not guarantee assistant access yet
AppFunctions use Android’s caller authorization and do not use the MCP server’s token. Open On-device assistants on Phone MCP’s home screen for an in-app explanation, or see the AppFunctions guide for the security model, example prompts, flavor differences, and ADB testing instructions.
Quick Start
Installation
- Download from Google Play: Available on Google Play Store
- Or build from source:
git clone https://github.com/yourusername/android-mcp-server
安装
npx mcp-remote http://<phone-ip>:3001/sse --header Authorization: Bearer <token> --allow-http配置
{
"mcpServers": {
"phone": {
"command": "npx",
"args": [
"mcp-remote",
"http://<phone-ip>:3001/sse",
"--header",
"Authorization: Bearer <token>",
"--allow-http"
]
}
}
}