Filesystem Android

🚀 安卓項目文件 MCP 服務器配置

本項目提供了一個 Claude MCP 服務器，用於訪問安卓項目文件。它能讓 AI 助手通過檢查必要的 Gradle 配置文件，瀏覽和讀取安卓項目源代碼，以此驗證項目的合法性，為開發者提供了便利。

🚀 快速開始

將以下配置添加到您的 Claude 客戶端 MCP 設置中：

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

⚠️ 重要提示

請將 /path/to/uv 替換為您實際的 UV 安裝路徑。

✨ 主要特性

• 項目驗證：通過檢查 Gradle 文件確保目錄是有效的安卓項目。
• 文件瀏覽：列出所有 Kotlin、KTS、TOML 文件及 AndroidManifest.xml，按目錄分組顯示。
• 文件讀取：提供安全訪問單個或多個文件的功能，並進行適當的過濾。
• 安全性：阻止對敏感目錄（如 .gradle、.git 和 build 文件夾）的訪問。

此工具非常適合希望利用 Claude 分析和處理安卓代碼庫的開發者。

📦 安裝指南

# 安裝缺失的 UV（如果有的話）
curl -LsSf https://astral.sh/uv/install.sh | sh

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

📄 許可證

本項目採用 MIT 許可證，詳細信息請參見 LICENSE。