apktool-mcp-server

Overview

The apktool-mcp-server is a sophisticated MCP implementation that integrates APK Tool with Model Context Protocol to enable real-time Android reverse engineering with AI assistants. It provides comprehensive tools for APK decompilation, manifest parsing, smali code analysis, and resource manipulation. The server is designed for security researchers, CTF participants, and mobile app developers who want to leverage AI for analyzing Android applications. The server is part of a larger MCP suite that includes tools for JADX integration and specialized clients. It demonstrates excellent engineering practices with clear documentation, multiple installation methods, and thoughtful integration with popular AI clients like Claude Desktop. The project is actively maintained with recent commits and addresses a specific niche in mobile security research through AI augmentation.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• build_apk

  Build an APK from a decoded APKTool Project

  Try:Build an APK from the current decoded projectTry:Rebuild the dvac APK after modifications
• get_manifest

  Get the AndroidManifest.xml content from a decoded APK project

  Try:Show me the AndroidManifest.xml for the dvac projectTry:Get the manifest content of the current APK
• get_apktool_yml

  Get apktool.yml information from a decoded APK project

  Try:Show the apktool.yml configuration for dvacTry:Get the project metadata from apktool.yml
• list_smali_directories

  List all smali directories in a project

  Try:List all smali directories for the dvac projectTry:Show the directory structure of smali code
• list_smali_files

  List smali files in a specific smali directory, optionally filtered by package prefix

  Try:List all smali files under package com.vulnerable.componentTry:Show me all smali files in the dvac project
• get_smali_file

  Get content of a specific smali file by class name

  Try:Get the smali code for MainActivityTry:Show me the content of com.example.MyClass.smali
• modify_smali_file

  Modify the content of a specific smali file

  Try:Add logging to MainActivity.smaliTry:Modify onCreate method to include additional validation
• list_resources

  List resources in a project, optionally filtered by resource type

  Try:List all layout resources in the projectTry:Show me all drawable resources
• get_resource_file

  Get content of a specific resource file

  Try:Show me the contents of strings.xmlTry:Get the layout resource for activity_main
• modify_resource_file

  Modify the content of a specific resource file

  Try:Replace http:// with https:// in strings.xmlTry:Modify the AndroidManifest.xml to add new permissions
• search_in_file

  Search for a pattern in files with specified extensions

  Try:Search for hardcoded URLs in .smali filesTry:Find all references to password in the project
• decode_apk

  Decode an APK file using APKTool, extracting resources and smali code

  Try:Decode dvac.apk and create a project called dvacTry:Extract resources from the target APK file

Comparable tools

Installation

# Install uv if not already installed
curl -LsSf https://astral.sh/uv/install.sh | sh

# Set up environment (optional)
uv venv
source .venv/bin/activate

# Install dependencies
uv pip install httpx fastmcp

{
    "mcpServers": {
        "apktool-mcp-server": {
            "command": "/path/to/uv",
            "args": [
                "--directory",
                "/path/to/apktool-mcp-server/",
                "run",
                "apktool_mcp_server.py"
            ]
        }
    }
}

FAQ

What is the relationship between apktool-mcp-server and APK Tool?

apktool-mcp-server is a MCP server that builds upon APK Tool, providing an AI-friendly interface to APK Tool's reverse engineering capabilities through the Model Context Protocol.

Which AI clients are compatible with this MCP server?

It's explicitly tested with Claude Desktop and works with Cherry Studio. The server also integrates well with Ollama and the Zin MCP Client for local LLM usage.

Compare apktool-mcp-server with