AI导哈

Android Studio诊断与状态监控工具

通过MCP向Codex提供Android Studio状态和运行时诊断的开发工具插件

  • by VitoSolin
  • Kotlin
  • 本地部署
  • 2 星标
  • 更新于
在 GitHub 查看 VitoSolin/AndroidStudio-MCP

使用说明

安卓工作室MCP

此存储库通过MCP向Codex公开Android Studio状态和Android运行时诊断。

它有三个部分：

  1. android-studio-mcp-plugin 一个Android Studio插件，在IDE进程中启动两个本地主机桥：
    • 主桥在 127.0.0.1:8765 IDE状态
    • 诊断桥打开 127.0.0.1:8766 用于编辑器诊断和运行会话检查
  2. android-studio-mcp-server 一个Python MCP服务器，将Codex MCP工具调用转换为对主桥的请求。
  3. android-runtime-companion 用于adb健康、重新运行恢复、logcat分析和诊断桥支持工具的Python MCP服务器。

需求

  • Android Studio构建 253.*
  • python 3.10+
  • Codex CLI
  • 仅当您从源代码构建插件时才使用JDK 21

GitHub Actions CI检查Ubuntu上的插件打包，以及Linux、macOS和Windows上的Python包。

插件项目默认为针对Android Studio构建 2025.3.2.6. 如果你想基于已安装的Android Studio副本进行构建，请设置 ANDROID_STUDIO_PATH 或通过 -PandroidStudioPath=/path/to/android-studio.

快速开始

1.构建并安装插件

cd android-studio-mcp-plugin
./gradlew buildPlugin

针对已安装的Android Studio进行构建的可选覆盖：

./gradlew buildPlugin -PandroidStudioPath="/path/to/android-studio"

从安装生成的zip android-studio-mcp-plugin/build/distributions/ 使用 Settings / Preferences > Plugins >齿轮图标> Install Plugin from Disk...，然后重新启动Android Studio。

2.在Android Studio中打开一个Android项目

网桥仅报告当前在IDE中打开的项目。

3.安装Python MCP服务器

主IDE状态服务器：

cd android-studio-mcp-server
python -m pip install -e .

可选运行时伴侣：

cd android-runtime-companion
python -m pip install -e .

如果您的环境暴露 python3 或 py 而不是 python，在安装和启动时始终使用该解释器。

4.将服务器添加到Codex

macOS和Linux：

codex mcp add android-studio -- python3 -m android_studio_mcp_server
codex mcp add android-runtime -- python3 -m android_runtime_companion

窗户：

codex mcp add android-studio -- py -m android_studio_mcp_server
codex mcp add android-runtime -- py -m android_runtime_companion

环境变量

  • ANDROID_STUDIO_MCP_BRIDGE_URL 违约： http://127.0.0.1:8765
  • ANDROID_STUDIO_MCP_BRIDGE_TOKEN 插件和Python服务器共享的可选承载令牌
  • ANDROID_STUDIO_MCP_BRIDGE_PORT 主桥的可选插件侧端口覆盖
  • ANDROID_STUDIO_EDITOR_DIAGNOSTICS_URL 违约： http://127.0.0.1:8766
  • ANDROID_STUDIO_EDITOR_DIAGNOSTICS_TOKEN 诊断桥的可选承载令牌
  • ANDROID_STUDIO_EDITOR_DIAGNOSTICS_PORT 诊断桥的可选插件侧端口覆盖
  • ANDROID_STUDIO_PATH 从源代码构建插件时使用的已安装Android Studio的可选路径

当前范围

android-studio-mcp-server 当前暴露：

  • 健康检查
  • 打开的项目
  • 每个项目的当前文件和打开的文件
  • 在整个项目中搜索文件名
  • 通过Android Studio索引进行符号搜索
  • 跨项目文件的纯文本搜索
  • 读取IDE解析的文件片段
  • 在特定行和列打开文件
  • 运行配置列表
  • 运行命名配置
  • IDE构建触发器和构建状态
  • Gradle同步状态
  • 连接的ADB设备列表
  • 通过IDE解析安全设备属性摘要 adb
  • 通过IDE安装的软件包列表已解决 adb
  • 通过IDE解析最近的logcat快照 adb，具有可选的包、优先级和子字符串筛选器

android-runtime-companion 当前暴露：

  • adb设备列表和健康检查
  • 强制停止并重新运行准备帮助程序
  • adb重启和模拟器终止助手
  • 对崩溃、ANR、启动失败和权限问题进行logcat分析
  • 当前文件或特定文件的编辑器诊断
  • Android Studio运行会话诊断
  • Android Studio运行或调试控制台尾部访问

冒烟测试

安装插件后，Android Studio正在运行，并且打开了一个项目：

python scripts/smoke_test_android_studio_mcp.py \
  --project-path "/absolute/path/to/open/android/project" \
  --wait-seconds 30

通过 --serial 如果你有多个在线模拟器或设备。

诊断

快速健康检查：

curl -s http://127.0.0.1:8765/health | jq
curl -s http://127.0.0.1:8766/health | jq

预期的健康领域包括：

  • pluginVersion
  • bridgeApiVersion
  • capabilities

如果 capabilities 如果主桥中缺少，正在运行的IDE仍在为较旧的插件版本提供服务，需要重新安装或重新启动。 如果诊断桥连接被拒绝，通常的修复方法是重新安装插件并重新启动Android Studio，以便加载插件。 如果桥接器报告了预期的功能，但Codex仍未显示相应的MCP工具，请启动新的Codex会话，以便重新加载MCP模式。

看 安卓工作室mcp插件/README.md, 安卓工作室mcp服务器/README.md, 安卓运行时伴侣/README.md，以及 docs/research.md 了解更多细节。

相关 MCP