README.md
Android Code Search MCP Server
English | 简体中文
A Model Context Protocol (MCP) server for searching and browsing Android source code via cs.android.com.
Preview
Features
- Code Search: Search through Android source code with regex support
- File Content: Retrieve full source file contents
- Symbol Suggestions: Get autocomplete suggestions for classes, methods, files
- Multiple Projects: Search across Android, AndroidX, Android Studio, and LLVM projects
Installation
Claude Code
claude mcp add cs-android -- npx -y cs-android-mcp
Other MCP Clients
Any MCP-compatible client can use the stdio transport:
npx -y cs-android-mcp
Or install globally:
npm install -g cs-android-mcp
cs-android-mcp
Available Tools
search_android_code
Search for code in Android source repositories.
| Parameter | Required | Description |
|---|---|---|
query |
Yes | Search query (supports regex, file:, class:, function: operators) |
project |
No | Filter by project: android, androidx, android-studio, android-llvm |
pageSize |
No | Number of results (default: 10, max: 50) |
contextLines |
No | Context lines around matches (default: 1) |
get_file_content
Get the full content of a source file.
| Parameter | Required | Description |
|---|---|---|
project |
Yes | Project name |
repository |
Yes | Repository path |
branch |
Yes | Branch name |
path |
Yes | File path |
suggest_symbols
Get symbol suggestions for partial queries.
| Parameter | Required | Description |
|---|---|---|
query |
Yes | Partial query |
maxResults |
No | Max suggestions (default: 7) |
list_projects
List all available Android source projects.
License
MIT
Tools 4
search_android_codeSearch for code in Android source repositories.get_file_contentGet the full content of a source file.suggest_symbolsGet symbol suggestions for partial queries.list_projectsList all available Android source projects.Try it
→Search for the implementation of the Activity class in the android project.
→Find all occurrences of 'onPause' in the AndroidX repository.
→Get the full source code for the file located at frameworks/base/core/java/android/app/Activity.java.
→List all available Android projects I can search through.
→Suggest symbols matching 'View' to help me find relevant UI classes.