Filesystem Android

🚀 Android Project File MCP Server Configuration

This project offers a Claude MCP server for accessing Android project files. It enables AI assistants to browse and read Android project source code by checking necessary Gradle configuration files, thus validating legitimate Android projects.

🚀 Quick Start

This project provides a Claude MCP server for accessing Android project files. It allows AI assistants to browse and read Android project source code by checking the necessary Gradle configuration files, thereby validating legitimate Android projects.

✨ Features

• Project Validation: Ensures the directory is a valid Android project by checking Gradle files.
• File Browsing: Lists all Kotlin, KTS, TOML files, and AndroidManifest.xml, grouped by directory.
• File Reading: Provides secure access to single or multiple files with appropriate filtering.
• Security: Blocks access to sensitive directories (e.g., .gradle, .git, and build folders).

This tool is ideal for developers who want to leverage Claude to analyze and process Android codebases.

📦 Installation

# Install the missing UV (if any)
curl -LsSf https://astral.sh/uv/install.sh | sh

# Initialize the project
uv venv
uv pip install -r uv.lock

📚 Documentation

Add the following configuration to your Claude client MCP settings:

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

⚠️ Important Note

Replace /path/to/uv with your actual UV installation path.

📄 License

This project is under the MIT License. For more details, see LICENSE.