Android Tools MCP

安卓工具MCP

一个Android Studio插件，将内置的Gemini代理工具作为 主控程序 服务器——因此任何AI编码工具都可以使用它们。

\[！警告\] 此插件使用 未记录的内部API 来自Android Studio的Gemini插件。这些API可以随时更改或中断，恕不另行通知。它是 不隶属于谷歌或不受谷歌认可。使用风险自负——最适合实验和个人工作流程，而不是生产CI管道。

\[！注意\] 需要 安卓熊猫工作室2025.3+ 启用Gemini插件（默认捆绑） Python 3.7+ 对于桥牌脚本。

______________________________________________________________________

快速启动

1.安装插件

从下载ZIP 发布 并通过安装 设置→ 插件→ 从磁盘安装插件 在Android Studio中。

2.下载桥接脚本

保存 android-studio-mcp.py 在你的机器上的某个地方。

3.连接到您最喜欢的工具 （参见 在......下面)

4.打开一个Android项目 在Android Studio中，MCP服务器会自动启动。

______________________________________________________________________

连接到您最喜欢的工具

\[！重要\] 总是使用 绝对路径 （例如。， /Users/you/android-studio-mcp.py)，不 ~大多数MCP客户端不扩展波浪号。

克劳德代码

claude mcp add android-studio -- python3 /absolute/path/to/android-studio-mcp.py

GitHub Copilot

添加 .vscode/mcp.json （或用户级别 settings.json 在...之下 github.copilot.mcp):

{
  "servers": {
    "android-studio": {
      "type": "stdio",
      "command": "python3",
      "args": ["/absolute/path/to/android-studio-mcp.py"]
    }
  }
}

千码

添加 ~/.config/kilo/kilo.jsonc:

{
  "mcp": {
    "android-studio": {
      "type": "local",
      "command": ["python3", "/absolute/path/to/android-studio-mcp.py"],
      "enabled": true
    }
  }
}

开源代码

添加 ~/.config/opencode/opencode.json:

{
  "mcp": {
    "android-studio": {
      "type": "local",
      "command": ["python3", "/absolute/path/to/android-studio-mcp.py"],
      "enabled": true
    }
  }
}

SSE本地客户

任何支持SSE传输的MCP客户端都可以直接连接，不需要桥接脚本：

http://127.0.0.1:24601/sse

______________________________________________________________________

可用工具（20）

所有工具都是特定于Android的。有意排除通用文件/代码工具。工具是在运行时从Gemini插件中动态发现的——当Android Studio使用新工具进行更新时，它们会自动出现。

Device tools (6)

Gradle tools (10)

Documentation & search tools (4)

______________________________________________________________________

自定义端口

默认情况下，服务器在端口上运行 24601。要更改它，请执行以下操作：

1. 在Android Studio中： Help → 编辑自定义虚拟机选项 → add -Dmcp.bridge.port=12345
2. 通过 --port 12345 到桥脚本

______________________________________________________________________

从源代码构建

git clone https://github.com/amsavarthan/android-tools-mcp
cd android-tools-mcp
./gradlew buildPlugin

ZIP插件被写入 build/distributions/。该构建将根据您本地的Android Studio安装进行编译——通过以下方式设置路径 local.properties (android.studio.path=...） env 是 ANDROID_STUDIO_PATH，或者默认为 /Applications/Android Studio.app.

______________________________________________________________________

故障排除

______________________________________________________________________

许可证

Apache 2.0