安卓工作室MCP
此存储库通过MCP向Codex公开Android Studio状态和Android运行时诊断。
它有三个部分：
android-studio-mcp-plugin
一个Android Studio插件，在IDE进程中启动两个本地主机桥： - 主桥在 127.0.0.1:8765 IDE状态 - 诊断桥打开 127.0.0.1:8766 用于编辑器诊断和运行会话检查
android-studio-mcp-server
一个Python MCP服务器，将Codex MCP工具调用转换为对主桥的请求。
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预期的健康领域包括：
pluginVersionbridgeApiVersioncapabilities
如果 capabilities 如果主桥中缺少，正在运行的IDE仍在为较旧的插件版本提供服务，需要重新安装或重新启动。 如果诊断桥连接被拒绝，通常的修复方法是重新安装插件并重新启动Android Studio，以便加载插件。 如果桥接器报告了预期的功能，但Codex仍未显示相应的MCP工具，请启动新的Codex会话，以便重新加载MCP模式。
看 安卓工作室mcp插件/README.md, 安卓工作室mcp服务器/README.md, 安卓运行时伴侣/README.md，以及 docs/research.md 了解更多细节。