Skip to main content

Model Context Protocol implementation for Frida

Project description

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/user-attachments/assets/5dc0e8f5-5011-4cf2-be77-6a77ec960501

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

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

iflow_mcp_dnakov_frida_mcp-0.1.1.tar.gz (7.2 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

iflow_mcp_dnakov_frida_mcp-0.1.1-py3-none-any.whl (8.0 kB view details)

Uploaded Python 3

File details

Details for the file iflow_mcp_dnakov_frida_mcp-0.1.1.tar.gz.

File metadata

File hashes

Hashes for iflow_mcp_dnakov_frida_mcp-0.1.1.tar.gz
Algorithm Hash digest
SHA256 42c7ac5909ca680d2957896511b9f67fd6ab8d9650f70648544a9dc659c2ee4b
MD5 ad727e90479edac19790ee5154da86cd
BLAKE2b-256 ff787bc0cca1cd159d68cbce129cc3f05d9600ab9358f306b580068e77a9f192

See more details on using hashes here.

File details

Details for the file iflow_mcp_dnakov_frida_mcp-0.1.1-py3-none-any.whl.

File metadata

File hashes

Hashes for iflow_mcp_dnakov_frida_mcp-0.1.1-py3-none-any.whl
Algorithm Hash digest
SHA256 8e391d1fb06cc23be6d3bbe5c74fdbdbff9912927ddb0fd6b7e9a619b3339454
MD5 75d97a5868d16c9060f4346e2b73fd7e
BLAKE2b-256 98a29e34df49fc7e6e3cec2efa6adf754b1332398439163875ffc673bcc71846

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page