Android Source Code Browser

🚀 Android Project File MCP Server Configuration

This project offers a Claude MCP server that enables secure access to Android project files. It allows AI assistants to browse and read the source code of Android projects, verifying legitimate Android projects by checking the necessary Gradle configuration files.

🚀 Quick Start

Server Setup

Add the following configuration to the MCP settings of your Claude client:

{
  "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.

Installation

# Install UV if not already installed
curl -LsSf https://astral.sh/uv/install.sh | sh

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

✨ Features

• Project Verification: Ensure the directory is a valid Android project by checking Gradle files.
• File Browsing: List all Kotlin, KTS, TOML files and AndroidManifest.xml, grouped by directory.
• File Reading: Provide secure access to read single or multiple files with appropriate filtering mechanisms.
• Security: Block access to sensitive directories (e.g., .gradle, .git, and build folders).

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

📄 License

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

Property	Details
License
Python Version