frida-mcp 0.1.0

Model Context Protocol implementation for Frida

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

https://github.com/dnakov/frida-mcp/raw/main/static/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 sessions
  • Script injection with progress tracking
• 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"
    }
  }
}

Alternatively, you can use the MCP CLI to install the server:

# Install using the module path
mcp install -m frida_mcp.cli

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

Script Injection

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

Development

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

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

License

MIT