filesystem-android

This MCP server provides secure access to Android project source code through Claude. It validates Android projects by detecting essential Gradle configuration files, enables browsing of Kotlin, Kotlin Script (KTS), TOML, and AndroidManifest.xml files grouped by directory, and allows reading of individual or multiple files with appropriate filtering to prevent exposure of sensitive data. Use it to help an AI assistant explore an Android codebase, understand project structure, and extract relevant code snippets without accessing restricted directories.

To use it, run the server with the provided UV-based command and connect your Claude client to the named MCP server (in this example, 'Android source code'). Once active, you can prompt the assistant to list files by directory, inspect specific Kotlin/KTS/TOML files, or read AndroidManifest.xml files. The server enforces security by blocking access to .gradle caches, .git directories, and build output folders to minimize risk of exposing secrets or large binaries.

Prerequisites:

• Python 3.10+ installed on your system
• UV (ultra-lean server) installed and accessible via the uvx command as described below

Install and run:

1. Install UV if missing:

curl -LsSf https://astral.sh/uv/install.sh | sh

2. Initialize a virtual environment and install dependencies:

uv venv
uv pip install -r uv.lock

3. Run the MCP server (as configured in the README):

uvx run --with mcp[cli] mcp run ./filesystem_android/main.py

Notes:

• Ensure the path ./filesystem_android/main.py is correct relative to where you run the command.
• If you customize the environment, you may need to export additional environment variables relevant to your UV setup.

Tips and tips:

• The server intentionally excludes sensitive directories like .gradle, .git, and build folders. If you encounter missing files that you know exist, verify that the path is not restricted and that the project structure includes the expected Gradle files.
• When multiple Android projects are in scope, you can prompt the AI to narrow down by directory or module to reduce noise.
• Ensure your Claude integration points to the MCP server alias exactly as configured (e.g., 'Android source code').
• If you update the filesystem layout or the main.py, restart the MCP server to pick up changes.