[WIP] Android Development MCP Server

A Model Context Protocol (MCP) server that provides Android development assistance following NowInAndroid best practices. This server can be used with any MCP-compatible AI tool (Claude, GPT, Gemini, etc.).

Features

Tools Available

Tool	Description
`get_quick_reference`	Quick overview of patterns and available tools
`get_architecture_reference`	Full architecture documentation (Data, Domain, UI layers)
`get_compose_patterns`	Jetpack Compose UI patterns
`get_modularization_guide`	Module structure and dependencies
`get_gradle_setup`	Build configuration and convention plugins
`get_testing_patterns`	Testing approach with test doubles
`generate_feature_module`	Generate complete feature module code
`generate_viewmodel`	Generate ViewModel with UiState
`generate_repository`	Generate offline-first repository
`search_documentation`	Search across all documentation

Quick Start

Option 1: Docker (Recommended)

# Build and run with Docker Compose
docker-compose up -d

# Or build and run manually
docker build -t android-dev-mcp .
docker run -d -p 3000:3000 --name android-mcp android-dev-mcp

The server will be available at:

SSE endpoint: http://localhost:3000/sse
Health check: http://localhost:3000/health

Option 2: Local Development

# Install dependencies
npm install

# Build
npm run build

# Run in SSE mode (for network access)
npm start -- --sse

# Or run in stdio mode (for local CLI)
npm start

Connecting AI Clients

Claude Desktop

Add to your Claude Desktop config (~/.config/claude/claude_desktop_config.json on Linux/Mac or %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "android-dev": {
      "transport": "sse",
      "url": "http://localhost:3000/sse"
    }
  }
}

Claude Code

claude mcp add android-dev --transport sse --url http://localhost:3000/sse

Other MCP Clients

Configure your MCP client with:

Transport: SSE
URL: http://localhost:3000/sse

Example Usage

Once connected, you can ask your AI assistant questions like:

"What's the recommended architecture for an Android app?"
"Generate a feature module for user-profile with package com.myapp"
"Show me the ViewModel pattern from NowInAndroid"
"How do I set up offline-first data sync?"
"Generate a repository for the Task entity"
"Search documentation for navigation"

API Endpoints

Endpoint	Method	Description
`/sse`	GET	SSE connection for MCP
`/messages`	POST	Message handling
`/health`	GET	Health check

Environment Variables

Variable	Default	Description
`PORT`	3000	Server port
`MCP_TRANSPORT`	sse	Transport mode (sse or stdio)
`NODE_ENV`	production	Node environment

Project Structure

android-dev-mcp/
├── src/
│   └── index.ts          # Main server code
├── references/           # Documentation files
│   ├── architecture.md
│   ├── compose-patterns.md
│   ├── gradle-setup.md
│   ├── modularization.md
│   └── testing.md
├── dist/                 # Compiled JavaScript
├── Dockerfile
├── docker-compose.yml
├── package.json
└── tsconfig.json

Extending the Server

Adding New Tools

Edit src/index.ts and add a new tool:

server.tool(
  "my_new_tool",
  "Description of what the tool does",
  {
    param1: {
      type: "string",
      description: "Parameter description",
    },
  },
  async ({ param1 }) => ({
    content: [{ type: "text", text: `Result for ${param1}` }],
  })
);

Adding New Documentation

Add markdown files to references/
Create a loader function in src/index.ts
Register a new tool to expose it

License

MIT

References

NowInAndroid - Google's reference Android app
Model Context Protocol - MCP specification
Android Architecture - Official guide