Android Studio 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 用于编辑器诊断和运行会话检查

1. android-studio-mcp-server

一个Python MCP服务器，将Codex MCP工具调用转换为对主桥的请求。

1. 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 了解更多细节。