Android Code Search

Queries Android source code, retrieves file contents, and suggests symbols across multiple Android projects via MCP.

javascript

8

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "steveday763-cs_android_mcp": {
      "command": "npx",
      "args": [
        "-y",
        "cs-android-mcp"
      ]
    }
  }
}

You can run this MCP server to search and browse Android source code through cs.android.com. It exposes practical capabilities like code search with regex, retrieving file contents, providing symbol suggestions, and supporting multiple Android projects for comprehensive browsing.

How to use

Connect to the MCP server using a compatible MCP client. You can interact with the server to search Android source code across multiple projects, fetch full file contents, request symbol autocomplete suggestions, and list available projects. Use descriptive queries with operators like file:, class:, and function: to refine results. The server supports regex search and returns relevant matches along with contextual lines.

Practical usage patterns you can perform: 1) Search Android source code with a query and optional project filter to limit results to android, androidx, android-studio, or android-llvm. 2) Retrieve the full content of a specific source file by providing the repository path and branch. 3) Request symbol suggestions for partial queries to speed up navigation. 4) Enumerate the list of available Android source projects you can search across.

How to install

Prerequisites: You need an environment with Node.js and npm installed. Ensure you have access to run commands from your shell or terminal.

Option A: Use the Claude Code integration command (suitable for Claude-enabled workflows) 1) Prepare the MCP integration for Claude 2) Run the following command in your shell to add the Android Code Search MCP server to Claude:

claude mcp add cs-android -- npx -y cs-android-mcp

Option B: Use a standard MCP transport with any MCP-compatible client. You can start the server by invoking the MCP package directly via npx, which downloads and runs the server without a global install:

npx -y cs-android-mcp

Option C: Install the MCP server globally and run it as a standalone command. This is useful if you want to invoke the server directly from your PATH:

npm install -g cs-android-mcp
cs-android-mcp

Notes about running modes

If you prefer a local, script-based integration, you can run the MCP transport via the standard stdio method shown above. Each method starts the same underlying server that exposes the available tools for Android code search and browsing.

Additional notes

The MCP server provides a set of tools that you can call through your client to perform specific actions. You can combine these tools with project filtering and contextual options to build efficient search workflows across Android, AndroidX, Android Studio, and LLVM projects.

Available tools

search_android_code

Search Android source repositories with regex support and optional project filtering to limit results to android, androidx, android-studio, or android-llvm.

get_file_content

Retrieve the full content of a source file by specifying project, repository, branch, and path.

suggest_symbols

Get autocomplete suggestions for partial symbol queries, with an optional maximum number of results.

list_projects

List all available Android source projects that you can search across.