Android Code Search MCP Server
# Android Code Search MCP Server
[](https://www.npmjs.com/package/cs-android-mcp)
[](https://www.npmjs.com/package/cs-android-mcp)
[](https://github.com/steveday763/cs_android_mcp)
[](https://opensource.org/licenses/MIT)
English | [简体中文](README_zh-CN.md)
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
```bash
claude mcp add cs-android -- npx -y cs-android-mcp
```
### Cursor
```json
{
"mcpServers": {
"cs-android": {
"command": "npx",
"args": ["-y", "cs-android-mcp"]
}
}
}
```
### Other MCP Clients
Any MCP-compatible client can use the stdio transport:
```bash
npx -y cs-android-mcp
```
Or install globally:
```bash
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
TDQS
Scored across 4 tools
Each tool has a clearly distinct purpose: get_file_content retrieves file contents, list_projects enumerates available projects, search_android_code performs code searches, and suggest_symbols provides symbol suggestions. There is no overlap in functionality, making tool selection straightforward for an agent.
Tool names follow a consistent verb_noun pattern (get_file_content, list_projects, search_android_code, suggest_symbols), with all using snake_case. The minor deviation is 'suggest_symbols' using a verb that is slightly less action-oriented than others, but overall naming is highly consistent and predictable.
With 4 tools, the server is well-scoped for Android code search functionality. Each tool serves a specific and necessary role in the domain (browsing, listing, searching, and suggesting), and there are no extraneous tools. The count is appropriate for the server's purpose.
The tool set covers core Android code search operations: listing projects, searching code, retrieving file contents, and suggesting symbols. A minor gap is the lack of advanced search filters or metadata operations, but the basic workflow is fully supported without dead ends.