+
+---
+
+MBrain est une passerelle Android pour le Model Context Protocol (MCP). Elle permet aux agents IA de consulter l’état du téléphone, de gérer les applications, de manipuler les fichiers et d’exécuter des commandes. Elle regroupe aussi des services MCP supplémentaires derrière un point d’accès unique. Choisissez les capacités à activer sur votre téléphone et arrêtez la passerelle à tout moment.
+
+## Aperçu
+
+
+
Accueil
Capacités
Paramètres
+
+
+
+
+
+
+
+Captures de l’application. Les outils disponibles dépendent des capacités activées et des services connectés. Thèmes clair, sombre et système disponibles.
+
+## Fonctionnalités
+
+| Capacité | Utilisation |
+| --- | --- |
+| **Informations sur l’appareil** | Consulter les caractéristiques, la batterie, le stockage et le réseau |
+| **Gestion des applications** | Lister, examiner et lancer les applications ; les accès privilégiés permettent aussi leur installation, désinstallation et arrêt |
+| **Commandes et fichiers** | Exécuter des commandes via Root ou Shizuku ; parcourir, lire, écrire, copier et déplacer des fichiers |
+| **Agrégation MCP** | Connecter des services HTTP MCP locaux ou gérer des processus stdio MCP |
+| **Point d’accès unique** | Rechercher les outils, consulter leur description, copier les paramètres de connexion et voir l’historique récent |
+| **Accès distant** | Utiliser le client frpc intégré pour exposer MBrain ou d’autres services du téléphone via des tunnels TCP |
+
+- **Activation à la demande :** Root et Shizuku disposent de commutateurs et de vérifications d’autorisation séparés.
+- **Contrôle immédiat :** démarrez ou arrêtez la passerelle depuis l’accueil ou arrêtez-la depuis la notification persistante.
+- **Services personnalisés :** renseignez vos propres noms et configurations, sans dépendre d’une application tierce particulière.
+
+## Démarrage rapide
+
+### 1. Installer MBrain
+
+Nécessite **Android 9.0 ou une version ultérieure**.
+
+Téléchargez `mbrain-v-universal.apk` depuis [GitHub Releases](https://github.com/powercess/mbrain/releases/latest) et installez-le sur votre appareil Android. L’APK universel prend en charge ARM64, ARM32, x86_64 et x86.
+
+Chaque publication comprend des notes de version et un fichier de sommes de contrôle `SHA256SUMS.txt`. Pour compiler l’application et utiliser les variantes de développement, consultez le [guide de développement](docs/development.md) (chinois simplifié).
+
+### 2. Choisir les capacités
+
+Ouvrez l’onglet **Capacités** :
+
+- Les informations sur l’appareil ne nécessitent pas Root.
+- Activez la gestion des applications selon vos besoins.
+- Pour les opérations privilégiées, activez **Root** ou **Shizuku** et accordez les autorisations demandées.
+
+Root nécessite un appareil rooté et une autorisation accordée à **MBrain lui-même**. Pour Shizuku, installez et démarrez [Shizuku](https://shizuku.rikka.app/). Les deux accès peuvent être activés séparément.
+
+### 3. Démarrer la passerelle
+
+Depuis **Accueil**, appuyez sur le bouton de démarrage en bas à droite. Une fois la passerelle en cours d’exécution, ouvrez les **coordonnées et identifiants de connexion** pour copier l’URL MCP et le jeton Bearer.
+
+## Connecter un agent IA
+
+Ajoutez un service dans un client prenant en charge **MCP sur HTTP et l’authentification Bearer** :
+
+| Paramètre | Valeur |
+| --- | --- |
+| Nom | `MBrain`, ou un nom personnalisé |
+| URL MCP | `http://127.0.0.1:8765/mcp` |
+| Authentification | Jeton Bearer |
+| Jeton | À copier depuis la page des identifiants dans MBrain |
+
+Pour une configuration par en-tête HTTP :
+
+```http
+Authorization: Bearer
+```
+
+Les **clients sur le même téléphone** utilisent directement cette adresse. Les **clients sur ordinateur** nécessitent une connexion ADB et une redirection de port :
+
+```bash
+adb forward tcp:8765 tcp:8765
+```
+
+Si le port par défaut est occupé, MBrain en choisit un disponible. Utilisez l’adresse et la commande ADB affichées dans l’application. Le jeton est chiffré sur l’appareil, conservé après redémarrage et réinitialisable depuis la page des identifiants.
+
+Commencez par une requête en lecture seule :
+
+> Vérifie le niveau de batterie et l’espace de stockage disponible sur ce téléphone.
+
+## Ajouter des services MCP
+
+Ouvrez **MCP → Ajouter un service**, puis choisissez :
+
+| Type | Usage | Configuration |
+| --- | --- | --- |
+| **Service HTTP** | Une autre application ou un processus exécute déjà le service sur le téléphone | Nom, URL locale, jeton facultatif |
+| **Processus géré** | MBrain démarre et gère un service stdio MCP | Nom, exécutable, arguments séparés, identité d’exécution |
+
+Enregistrez, puis sélectionnez **Connecter le service** dans ses détails. Ses outils rejoignent le catalogue et deviennent accessibles via la même URL MCP.
+
+Les services HTTP doivent actuellement utiliser une adresse de bouclage. Préparez les exécutables et les environnements nécessaires sur l’appareil avant d’ajouter un processus géré : MBrain n’inclut ni Node.js ni Python.
+
+## Accès distant
+
+Le client **frpc** intégré peut rediriger MBrain ou d’autres services du téléphone via un serveur **frps** que vous hébergez. Dans **Paramètres → Accès distant → Configurer le serveur**, saisissez l’adresse, le port et le jeton, puis ajoutez des tunnels TCP.
+
+Tous les tunnels partagent une configuration de serveur. Chacun dispose de commandes indépendantes de démarrage, d’arrêt et de nouvelle tentative. Les tunnels MCP suivent le cycle de vie de la passerelle ; les tunnels personnalisés fonctionnent indépendamment. Seule la redirection TCP de base est prise en charge. Consultez le [guide d’accès distant](docs/remote-access.md) (chinois simplifié).
+
+## Autorisations et sécurité
+
+- La passerelle écoute uniquement sur l’interface de bouclage du téléphone. Utilisez ADB depuis un ordinateur et les tunnels configurés pour l’accès distant.
+- Tout client disposant du jeton peut appeler **tous les outils activés**. Les autorisations par client ne sont pas encore prises en charge.
+- Les outils Root et Shizuku peuvent modifier réellement l’appareil. Connectez uniquement des clients de confiance et gardez le jeton privé.
+- Choisissez les capacités sur le téléphone et arrêtez la passerelle lorsque l’accès n’est plus nécessaire.
+
+## FAQ
+
+
+Puis-je utiliser MBrain sans Root ?
+
+Oui. Les informations sur l’appareil, la consultation et le lancement ordinaires d’applications ainsi que les services HTTP MCP locaux ne nécessitent pas Root. Shizuku offre un autre accès privilégié, dont les possibilités dépendent de son mode de démarrage.
+
+
+
+
+Pourquoi mon client ne se connecte-t-il pas ?
+
+Vérifiez que la passerelle fonctionne et que le jeton correspond à celui affiché dans l’application. Sur ordinateur, vérifiez la redirection ADB du port réel. La passerelle écoute uniquement sur l’interface de bouclage ; l’accès distant nécessite un tunnel TCP configuré.
+
+
+
+
+Pourquoi un outil est-il absent ?
+
+La liste dépend des capacités activées, des autorisations et des services connectés. Vérifiez les onglets Capacités et MCP, puis actualisez les outils dans votre client.
+
+
+
+
+Que se passe-t-il lorsque j’arrête la passerelle ?
+
+MBrain n’accepte plus de requêtes, déconnecte les services MCP externes et termine les processus enfants directement gérés. La passerelle ne démarre pas automatiquement au démarrage du téléphone. L’historique reste uniquement en mémoire.
+
+
+
+## Contribuer
+
+Les signalements, suggestions, améliorations de documentation et contributions de code sont les bienvenus. Utilisez les [modèles de tickets](https://github.com/powercess/mbrain/issues/new/choose) en précisant la version et les étapes de reproduction. Masquez les jetons et les informations privées dans les captures et journaux.
+
+Le [guide de contribution](CONTRIBUTING.md) (anglais) décrit l’installation, la compilation, les vérifications et les pull requests. Créez une branche dédiée à partir du dernier `dev` et ciblez `dev` pour votre pull request. Le [guide de développement](docs/development.md) (chinois simplifié) détaille les tests sur appareil.
+
+## Remerciements
+
+- [droid-mcp](https://github.com/stixez/droid-mcp) : base Android MCP utilisée par MBrain, avec conservation de sa [licence Apache-2.0](vendor/droid-mcp/LICENSE) et de son [historique de provenance](vendor/droid-mcp/UPSTREAM.md).
+- [Shizuku](https://github.com/RikkaApps/Shizuku) et [libsu](https://github.com/topjohnwu/libsu) : accès privilégiés Android.
+- [RikkaHub](https://github.com/rikkahub/rikkahub) : référence pour les listes de paramètres et les interactions.
+
+## Star History
+
+Si MBrain vous est utile, vous pouvez soutenir le projet avec une étoile.
+
+
+
+
+
+
+
+Graphique fourni par Star History.
diff --git a/README.ja.md b/README.ja.md
new file mode 100644
index 0000000..dacf7d6
--- /dev/null
+++ b/README.ja.md
@@ -0,0 +1,186 @@
+
-[快速上手](#快速上手) · [连接 Agent](#连接-agent) · [接入 MCP 服务](#接入-mcp-服务) · [常见问题](#常见问题) · [反馈问题](https://github.com/powercess/mbrain/issues)
+[简体中文](README.zh_CN.md) | [繁體中文](README.zh_TW.md) | **English** | [Français](README.fr.md) | [日本語](README.ja.md)
+
+[Quick start](#quick-start) · [Connect an agent](#connect-an-ai-agent) · [Add MCP services](#add-mcp-services) · [FAQ](#faq) · [Report an issue](https://github.com/powercess/mbrain/issues)
---
-MBrain 是运行在 Android 上的 MCP 网关。它把手机自身的能力和你接入的 MCP 服务汇集到一个入口,让支持 MCP 的 AI 客户端读取设备状态、管理应用、操作文件或执行命令。你可以在手机上选择开放哪些能力,并随时停止服务。
+MBrain is an Android gateway for the Model Context Protocol (MCP) that lets AI agents access device information, manage apps, operate files, execute commands, and connect to additional MCP services through one unified endpoint. Enable only the capabilities you need and stop the gateway at any time.
-## 界面预览
+## Screenshots
-
首页
-
能力管理
-
设置
+
Home
+
Capabilities
+
Settings
-
-
-
+
+
+
-应用实际运行截图。可用工具数量取决于已启用能力和接入服务;支持浅色、深色及跟随系统。
+Screenshots from the running app. Available tools depend on enabled capabilities and connected services. Light, dark, and system themes are supported.
-## 可以做什么
+## Features
-| 能力 | 用途 |
+| Capability | What it provides |
| --- | --- |
-| **读取设备状态** | 查看设备信息、电量、存储空间和网络状态 |
-| **管理应用** | 查看应用列表与详情、启动应用;高权限通道还可安装、卸载和停止应用 |
-| **执行命令与操作文件** | 通过 Root 或 Shizuku 执行命令,浏览、读取、写入、复制和移动文件 |
-| **接入其他 MCP 服务** | 添加手机本机的 HTTP MCP 服务,或由 MBrain 启动和管理 stdio MCP 进程 |
-| **统一管理与连接** | 一个 MCP 地址提供工具目录,支持搜索工具、查看说明、复制连接信息和查看近期运行记录 |
-| **内网穿透** | 内置 frpc,统一配置一台服务器,多条基础 TCP 隧道转发 MBrain 或手机其他服务 |
+| **Device information** | Read device details, battery, storage, and network status |
+| **App management** | List, inspect, and launch apps; privileged channels can also install, uninstall, and stop apps |
+| **Commands and files** | Run commands through Root or Shizuku and browse, read, write, copy, or move files |
+| **MCP service aggregation** | Add local HTTP MCP services or let MBrain manage stdio MCP processes |
+| **One endpoint** | Expose one searchable tool catalog with connection details and recent run history |
+| **Remote access** | Use the built-in frpc client to forward MBrain or other phone services through TCP tunnels |
-- **按需启用**:Root 和 Shizuku 各用一个开关,打开时自动检查并申请权限。
-- **随时停止**:首页右下角一键启停,也可从前台通知停止网关。
-- **服务自由添加**:填写自己的服务名称与配置,不绑定特定第三方应用。
+- **Opt-in capabilities:** Root and Shizuku have separate switches and permission checks.
+- **One-tap control:** Start or stop the gateway from Home or the foreground notification.
+- **Bring your own services:** Add service names and configurations without being tied to a specific third-party app.
-## 快速上手
+## Quick start
-### 1. 安装 MBrain
+### 1. Install MBrain
-需要 **Android 9.0 或更高版本**。
+Requires **Android 9.0 or later**.
-从 [GitHub Releases](https://github.com/powercess/mbrain/releases/latest) 下载最新版本的 `mbrain-v版本号-universal.apk`,在 Android 设备上打开并安装。通用安装包覆盖 ARM64、ARM32、x86_64 和 x86,无需挑选架构。
+Download the latest `mbrain-v-universal.apk` from [GitHub Releases](https://github.com/powercess/mbrain/releases/latest) and install it on your Android device. The universal APK supports ARM64, ARM32, x86_64, and x86.
-发行页面提供更新说明和 `SHA256SUMS.txt` 校验文件。自行构建及开发测试版说明见[开发指南](docs/development.md)。
+Releases include notes and a `SHA256SUMS.txt` checksum file. See the [development guide](docs/development.md) for local builds and development variants.
-### 2. 选择需要开放的能力
+### 2. Choose capabilities
-打开底部的 **能力** 页面:
+Open the **Capabilities** tab:
-- 设备信息不需要 Root。
-- 按需启用应用管理。
-- 需要高权限操作时,进入 **Root** 或 **Shizuku**,打开启用开关,并完成授权。
+- Device information does not require Root.
+- Enable app management when needed.
+- For privileged operations, enable **Root** or **Shizuku** and complete authorization.
-使用 Root 需要设备具备 Root 能力,并允许 **MBrain 本身**获取权限。使用 Shizuku 则需先安装并启动 [Shizuku](https://shizuku.rikka.app/)。两种通道可以分别启用,不需要同时开启。
+Root requires a rooted device and permission granted to **MBrain itself**. Shizuku requires [Shizuku](https://shizuku.rikka.app/) to be installed and running. The two channels can be enabled independently.
-### 3. 启动网关
+### 3. Start the gateway
-回到 **首页**,点击右下角的启动按钮。显示“运行中”后,打开 **连接地址与凭据**,获取 MCP 地址和 Bearer Token。
+Return to **Home**, tap the start button, then open **Connection details and credentials** to copy the MCP URL and Bearer token.
-## 连接 Agent
+## Connect an AI agent
-在支持 **HTTP MCP 和 Bearer 认证**的客户端中添加服务:
+Add MBrain to a client that supports **HTTP MCP and Bearer authentication**:
-| 配置项 | 填写内容 |
+| Setting | Value |
| --- | --- |
-| 名称 | `MBrain`,也可自行命名 |
-| MCP 地址 | `http://127.0.0.1:8765/mcp` |
-| 认证方式 | Bearer Token |
-| Token | 从 MBrain 的“连接地址与凭据”页面复制 |
+| Name | `MBrain`, or a name of your choice |
+| MCP URL | `http://127.0.0.1:8765/mcp` |
+| Authentication | Bearer token |
+| Token | Copy from the app's connection credentials page |
-如果客户端通过请求头配置认证,填写:
+For clients configured through request headers:
```http
-Authorization: Bearer <从 MBrain 复制的 Token>
+Authorization: Bearer
```
-**同一台手机上的客户端**可以直接使用上述地址。
-
-**电脑上的客户端**需要先通过 ADB 连接手机,再转发端口:
+**Clients on the same phone** can use the URL directly. **Desktop clients** need an ADB connection and port forwarding:
```bash
adb forward tcp:8765 tcp:8765
```
-默认端口被占用时,网关会自动使用空闲端口。请以“连接地址与凭据”中的实际地址及“使用说明”中的 ADB 命令为准。Token 加密保存在设备上,重启后保持不变;可在凭据页重置。
+If the default port is occupied, MBrain chooses an available port. Use the actual URL and ADB command shown in the app. The token is encrypted on the device, persists across restarts, and can be reset from the credentials page.
+
+Try a simple read-only request:
-**远程客户端**可在“设置 → 内网穿透”配置一台自建 frps,再添加 TCP 隧道。每条隧道独立启停与重试;MCP 隧道跟随网关,自定义服务隧道独立运行。具体见[内网穿透指南](docs/remote-access.md)。
+> Check this phone's battery level and available storage.
-连接后可以先让 Agent 执行一个简单的只读请求:
+## Add MCP services
-> 查看这台手机的电量和剩余存储空间。
+Open **MCP → Add service** and choose a connection type:
-> **权限说明**:当前持有 Token 的客户端可以调用全部已启用工具,尚不支持为不同客户端单独分配权限。Root / Shizuku 工具能够执行实际修改,请只连接可信客户端,不要分享 Token。
+| Type | Use case | Configuration |
+| --- | --- | --- |
+| **HTTP service** | Another app or process already runs the service on the phone | Name, local URL, optional token |
+| **Managed process** | MBrain starts and manages a stdio MCP process | Name, executable, individual arguments, execution identity |
-## 接入 MCP 服务
+Save the configuration and select **Connect service** in its details. Connected tools join the gateway's catalog and are available through the same MCP endpoint.
-需要从公网连接时,可进入 **设置 → 内网穿透 → 配置服务器** 填写 frps 地址、端口和 Token。当前仅支持基础 TCP 转发,所有隧道共用一台服务器。配置示例与运行规则见[内网穿透指南](docs/remote-access.md)。
+HTTP services currently require loopback addresses. Prepare executables and runtimes on the device before adding managed processes; MBrain does not bundle Node.js or Python.
-进入 **MCP → 添加服务**,选择连接方式:
+## Remote access
-| 方式 | 适用情况 | 需要填写 |
-| --- | --- | --- |
-| **HTTP 服务** | 服务已经由手机上的其他应用或进程启动 | 名称、本机服务地址、可选 Token |
-| **托管进程** | 希望由 MBrain 启动并管理 stdio MCP 服务 | 名称、程序、逐项启动参数、执行身份 |
+The built-in **frpc** client can forward MBrain or other phone services through a self-hosted **frps** server. Open **Settings → Remote access → Configure server**, enter the server address, port, and token, then add TCP tunnels.
+
+All tunnels share one server configuration. Each tunnel has independent start, stop, and retry controls. MCP tunnels follow the gateway lifecycle; custom service tunnels run independently. Only basic TCP forwarding is supported. See the [remote access guide](docs/remote-access.md) (Simplified Chinese) for configuration and operating rules.
-保存配置后,在服务详情中点击 **连接服务**。成功连接后,该服务的工具会加入 MBrain 的工具目录,Agent 可以通过同一个入口调用。
+## Permissions and security
-HTTP 服务目前只支持回环地址。托管进程所需的程序和运行环境需要事先在设备上准备好,MBrain 不内置 Node.js 或 Python。
+- The gateway listens only on the phone's loopback interface. Desktop access uses ADB forwarding; remote access uses configured tunnels.
+- Any client with the Bearer token can call **all enabled tools**. Per-client permissions are not currently supported.
+- Root and Shizuku tools can make real changes to the device. Connect trusted clients and keep the token private.
+- Choose capabilities on the phone and stop the gateway whenever access is no longer needed.
-## 常见问题
+## FAQ
-没有 Root,能使用吗?
+Can I use MBrain without Root?
-可以。设备信息、普通应用查询与启动、本机 HTTP MCP 接入不依赖 Root。需要更高权限时,可以使用 Shizuku;实际操作范围取决于它的启动方式。
+Yes. Device information, ordinary app queries and launching, and local HTTP MCP services do not require Root. Shizuku provides another channel for privileged operations; its capabilities depend on how it was started.
-为什么客户端连接不上?
+Why can't my client connect?
-先确认首页显示“运行中”,并使用凭据页中的 Token。电脑连接时还需确认实际端口的 ADB 转发成功。网关仅监听手机回环地址;远程访问通过已配置的 TCP 隧道连接。
+Check that the gateway is running and the token matches the credentials page. For desktop access, verify ADB forwarding for the actual port. The gateway listens only on loopback; remote connections require a configured TCP tunnel.
-为什么找不到某个工具?
+Why is a tool missing?
-工具数量随能力开关、权限状态和外部服务连接情况变化。先在能力页检查开关,再到 MCP 页检查服务状态,最后在客户端重新获取工具列表。
+Available tools depend on capability switches, permissions, and external service connections. Check Capabilities and MCP service status, then refresh the tool list in your client.
-停止服务后会发生什么?
+What happens when I stop the gateway?
-网关停止接收请求,断开外部 MCP 连接,并清理直接托管的子进程。应用不会在开机后自动启动网关;运行记录目前仅保留在内存中。
+MBrain stops accepting requests, disconnects external MCP services, and cleans up directly managed child processes. It does not automatically start the gateway at boot. Run history is currently kept only in memory.
-## 反馈与参与
+## Contributing
-遇到问题或有功能建议,欢迎通过 [Issue 模板](https://github.com/powercess/mbrain/issues/new/choose)反馈。描述问题时请附上版本和复现步骤;截图或日志中请隐去 Token 与私人信息。
+Bug reports, feature suggestions, documentation improvements, and code contributions are welcome. Use the [issue templates](https://github.com/powercess/mbrain/issues/new/choose) and include the app version and reproduction steps. Remove tokens and private information from screenshots and logs.
-Contributions through bug reports, documentation improvements, and code are welcome. Read the [contributing guide](CONTRIBUTING.md) for local setup, building and running the app, validation, and the pull request workflow. Start each contribution on a dedicated branch based on the latest `dev` and target `dev` in your pull request. For detailed device testing, see the [development guide](docs/development.md).
+Read the [contributing guide](CONTRIBUTING.md) for setup, building, validation, and the pull request workflow. Start from the latest `dev` on a dedicated branch and target `dev` in your pull request. The [development guide](docs/development.md) (Simplified Chinese) covers device testing.
-## 致谢
+## Acknowledgements
-- [droid-mcp](https://github.com/stixez/droid-mcp):MBrain 使用的 Android MCP 基座,保留其 [Apache-2.0 许可证](vendor/droid-mcp/LICENSE)和[来源记录](vendor/droid-mcp/UPSTREAM.md)。
-- [Shizuku](https://github.com/RikkaApps/Shizuku) 与 [libsu](https://github.com/topjohnwu/libsu):Android 高权限能力接入。
-- [RikkaHub](https://github.com/rikkahub/rikkahub):设置列表与交互设计参考。
+- [droid-mcp](https://github.com/stixez/droid-mcp): the Android MCP foundation used by MBrain, with its [Apache-2.0 license](vendor/droid-mcp/LICENSE) and [upstream record](vendor/droid-mcp/UPSTREAM.md) retained.
+- [Shizuku](https://github.com/RikkaApps/Shizuku) and [libsu](https://github.com/topjohnwu/libsu): Android privileged access.
+- [RikkaHub](https://github.com/rikkahub/rikkahub): settings list and interaction design reference.
## Star History
-如果 MBrain 对你有帮助,欢迎点一个 Star。
+If MBrain is useful to you, consider giving it a star.
-
+
-Star 趋势由 Star History 提供。
+Chart provided by Star History.
diff --git a/README.zh_CN.md b/README.zh_CN.md
new file mode 100644
index 0000000..8d3e730
--- /dev/null
+++ b/README.zh_CN.md
@@ -0,0 +1,193 @@
+