Frida MCP

A Model Context Protocol (MCP) implementation for Frida dynamic instrumentation toolkit.

Overview

This package provides an MCP-compliant server for Frida, enabling AI systems to interact with mobile and desktop applications through Frida's dynamic instrumentation capabilities. It uses the official MCP Python SDK to enable seamless integration with AI applications.

Demo

frida-mcp.mov

Features

• Built with the official MCP Python SDK
• Comprehensive Frida tools exposed through MCP:
  • Process management (list, attach, spawn, resume, kill)
  • Device management (USB, remote devices)
  • Interactive JavaScript REPL with real-time execution
  • Script injection with progress tracking
  • Process and device monitoring
• Resources for providing Frida data to models
• Prompts for guided Frida analysis workflows
• Progress tracking for long-running operations
• Full support for all MCP transport methods

Installation

Prerequisites

• Python 3.8 or later
• pip package manager
• Frida 16.0.0 or later

Quick Install

pip install frida-mcp

Development Install

# Clone the repository
git clone https://github.com/yourusername/frida-mcp.git
cd frida-mcp

# Install in development mode with extra tools
pip install -e ".[dev]"

Claude Desktop Integration

To use Frida MCP with Claude Desktop, you'll need to update your Claude configuration file:

1. Locate your Claude Desktop configuration file:

   • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
   • Windows: %APPDATA%\Claude\claude_desktop_config.json
   • Linux: ~/.config/Claude/claude_desktop_config.json

2. Add the following to your configuration file:

{
  "mcpServers": {
    "frida": {
      "command": "frida-mcp"
    }
  }
}

Usage

Once installed, you can use Frida MCP directly from Claude Desktop. The server provides the following capabilities:

Process Management

• List all running processes
• Attach to specific processes
• Spawn new processes
• Resume suspended processes
• Kill processes

Device Management

• List all connected devices (USB, remote)
• Get device information
• Connect to specific devices

Interactive JavaScript REPL

• Create interactive sessions with processes
• Execute JavaScript code in real-time
• Monitor process state and memory
• Hook functions and intercept calls
• Capture console.log output
• Handle errors and exceptions gracefully

Script Injection

• Inject custom JavaScript scripts
• Track injection progress
• Handle script errors and exceptions

Resources

• Get Frida version information
• Access process list in human-readable format
• Access device list in human-readable format

Development

# Clone repository
git clone https://github.com/yourusername/frida-mcp.git
cd frida-mcp

# Install development dependencies
pip install -e ".[dev]"

License

MIT