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。