https://github.com/dnakov/frida-mcp
MCP stdio server for frida
https://github.com/dnakov/frida-mcp
Last synced: 5 months ago
JSON representation
MCP stdio server for frida
- Host: GitHub
- URL: https://github.com/dnakov/frida-mcp
- Owner: dnakov
- License: mit
- Created: 2025-03-27T13:19:40.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-03-27T13:24:28.000Z (6 months ago)
- Last Synced: 2025-05-07T20:17:30.426Z (5 months ago)
- Language: Python
- Size: 71.7 MB
- Stars: 44
- Watchers: 2
- Forks: 10
- Open Issues: 2
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Frida Mcp - Enables dynamic instrumentation of mobile and desktop applications through the Frida toolkit, providing process management and debugging via MCP. A technical example of extending MCP servers for application analysis. ([Read more](/details/frida-mcp.md)) `debugging` `instrumentation` `mcp` `frida` (Testing & Debugging Tools)
- awesome-rainmana - dnakov/frida-mcp - MCP stdio server for frida (Python)
README
# 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](https://github.com/modelcontextprotocol/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
```bash
pip install frida-mcp
```
### Development Install
```bash
# 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:
```json
{
"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
```bash
# Clone repository
git clone https://github.com/yourusername/frida-mcp.git
cd frida-mcp
# Install development dependencies
pip install -e ".[dev]"
```
## License
MIT