AOSP Explorer

v1.0.0Developer Toolsstable

MCP server for exploring AOSP internals and Jetpack libraries

androidjetpackjetpack-composemcpmcp-server
Share:
91
Stars
0
Downloads
0
Weekly
0/5

What is AOSP Explorer?

AOSP Explorer is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to mcp server for exploring aosp internals and jetpack libraries

MCP server for exploring AOSP internals and Jetpack libraries

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP server for exploring AOSP internals and Jetpack librarie

Use Cases

Explore Android Open Source Project internals.
Search and understand Jetpack library code.
Analyze Android framework components and APIs.
mrmike

Maintainer

LicenseApache-2.0
Languagepython
Versionv1.0.0
UpdatedMay 8, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx android-source-explorer

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use AOSP Explorer

Android Source Explorer MCP is a server that gives AI assistants offline access to AOSP (Android Open Source Project) internals and Jetpack library source code. It uses a dual-engine architecture — Tree-sitter for sub-10ms structural parsing and an optional Language Server Protocol (LSP) engine for cross-file definition resolution and reference finding. Android developers use it to let Claude or other AI clients navigate framework classes, understand Jetpack Compose internals, and answer deep questions about Android platform APIs without leaving their development environment.

Prerequisites

  • Python 3.11+ or uv package manager installed
  • Git installed for cloning the package
  • An MCP-compatible client such as Claude Desktop, Cursor, or VS Code with Copilot
  • Sufficient disk space for Android source files (several GB depending on API level and Jetpack modules selected)
  • Internet connection for the initial sync of AOSP and AndroidX sources
1

Install android-source-explorer via uv

Install the package directly from GitHub using uv tool install. This is the recommended approach as it manages the Python environment automatically.

uv tool install git+https://github.com/mrmike/android-source-explorer-mcp
2

Sync Android source files

Download AOSP source for your target API level and the Jetpack AndroidX libraries you need. This step fetches the actual source code that the MCP server will index and serve.

android-source-explorer sync --api-level 36 --androidx "compose,lifecycle,activity"
3

Optionally download LSP servers

For advanced cross-file analysis (go-to-definition, find-references, type documentation), download the Language Server Protocol servers. This is optional but recommended for deep exploration.

android-source-explorer sync --lsp
4

Configure your MCP client (basic)

Add android-source-explorer to your MCP client configuration. The server starts in serve mode and exposes tools for searching and reading Android source code.

{
  "mcpServers": {
    "android-sources": {
      "command": "android-source-explorer",
      "args": ["serve"]
    }
  }
}
5

Enable LSP tools (optional)

Set the ANDROID_SOURCE_LSP environment variable to true to activate cross-file definition resolution and reference finding through the LSP engine.

{
  "mcpServers": {
    "android-sources": {
      "command": "android-source-explorer",
      "args": ["serve"],
      "env": {
        "ANDROID_SOURCE_LSP": "true"
      }
    }
  }
}

AOSP Explorer Examples

Client configuration

Full Claude Desktop configuration with LSP enabled for deep AOSP and Jetpack source exploration.

{
  "mcpServers": {
    "android-sources": {
      "command": "android-source-explorer",
      "args": ["serve"],
      "env": {
        "ANDROID_SOURCE_LSP": "true"
      }
    }
  }
}

Prompts to try

Use natural language to explore AOSP internals and Jetpack library code.

- "Show me the source code for ActivityResultLauncher in AndroidX Activity"
- "How does Compose's remember() function work internally? Show the implementation"
- "Find all classes that extend ViewModel in the lifecycle library"
- "What methods does the Android Binder class expose? List them with signatures"
- "Search for usages of CoroutineScope in the Jetpack Lifecycle source"

Troubleshooting AOSP Explorer

android-source-explorer command not found after installation

Ensure the uv tool bin directory is in your PATH. Run 'uv tool update-shell' or add $(uv tool dir)/bin to your PATH in your shell profile (~/.zshrc or ~/.bashrc).

Sync fails or downloads incomplete source

Check your internet connection and available disk space. Re-run the sync command — it supports resuming. If a specific AndroidX module fails, try syncing modules individually by name.

LSP tools are not available despite setting ANDROID_SOURCE_LSP=true

You must first run 'android-source-explorer sync --lsp' to download the LSP server binaries. After downloading, restart the MCP server and the LSP-powered tools will appear.

Frequently Asked Questions about AOSP Explorer

What is AOSP Explorer?

AOSP Explorer is a Model Context Protocol (MCP) server that mcp server for exploring aosp internals and jetpack libraries It connects AI assistants to external tools and data sources through a standardized interface.

How do I install AOSP Explorer?

Follow the installation instructions on the AOSP Explorer GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with AOSP Explorer?

AOSP Explorer works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is AOSP Explorer free to use?

Yes, AOSP Explorer is open source and available under the Apache-2.0 license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "android-source-explorer": { "command": "npx", "args": ["-y", "android-source-explorer"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use AOSP Explorer?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides