Android Source Code Browser

🚀 Android 项目文件 MCP 服务器配置

本项目提供了一个 Claude MCP 服务器，可支持安全访问 Android 项目的文件。借助该服务器，AI 助手能够浏览和阅读 Android 项目的源代码，同时会通过检查必要的 Gradle 配置文件来验证项目是否为合法的 Android 项目，为开发者带来便利。

🚀 快速开始

将以下配置添加到您的 Claude 客户端的 MCP 设置中：

{
  "mcpServers": {
    "Android 源代码": {
      "command": "/path/to/uv", 
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "./filesystem_android/main.py"
      ]
    }
  }
}

⚠️ 重要提示

请将 /path/to/uv 替换为您实际的 UV 安装路径。

✨ 主要特性

• 项目验证：通过检查 Gradle 文件确保目录是有效的 Android 项目。
• 文件浏览：列出所有 Kotlin、KTS、TOML 文件以及 AndroidManifest.xml 并按目录分组。
• 文件阅读：提供安全访问以读取单个或多个文件，带有适当的过滤机制。
• 安全性：阻止对敏感目录（如 .gradle、.git 和 build 文件夹）的访问。

此工具非常适合希望利用 Claude 来帮助理解、分析和处理 Android 代码库的开发者。

📦 安装指南

# 如果没有安装，请先安装 UV
curl -LsSf https://astral.sh/uv/install.sh | sh

# 初始化项目
uv venv
uv pip install -r uv.lock

📄 许可证

本项目采用 MIT 许可证，详细信息请参阅 LICENSE。