Skip to main content
Glama

Frida MCP Server | Frida MCP 服务器

English | 中文

English

A Model Context Protocol (MCP) server that enables AI models to perform Android dynamic analysis using Frida.

Project Structure

frida-mcp/
├── frida_mcp.py          # Core MCP server implementation
├── pyproject.toml        # Project dependencies and configuration  
├── requirements.txt      # Alternative dependency file
├── config.json           # Optional Frida server configuration
├── README.md            # Documentation
└── .gitignore           # Git ignore rules

Core Files

  • frida_mcp.py: Main MCP server with Frida integration

  • pyproject.toml: Modern Python project configuration (recommended)

  • requirements.txt: Traditional dependency file

  • config.json: Optional configuration for frida-server settings

Installation

# Clone repository
git clone http://git.dev.sh.ctripcorp.com/octopus/frida-mcp.git
cd frida-mcp

# Install dependencies (choose one method)
# Method 1: Using pip + requirements.txt
pip install -r requirements.txt

# Method 2: Using pip + pyproject.toml (recommended)
pip install -e .

# Setup frida-server on Android device
adb push frida-server /data/local/tmp/
adb shell "chmod 755 /data/local/tmp/frida-server"
adb shell "su -c /data/local/tmp/frida-server &"

MCP Configuration

Add to your MCP client configuration (e.g., Claude Desktop config file):

Windows (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "frida": {
      "command": "python",
      "args": ["C:\\Users\\YourName\\frida-mcp\\frida_mcp.py"],
      "transport": "stdio"
    }
  }
}

macOS/Linux (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "frida": {
      "command": "python",
      "args": ["/home/username/frida-mcp/frida_mcp.py"],
      "transport": "stdio"
    }
  }
}

Configuration (Optional)

The config.json file contains optional Frida server configuration:

{
  "server_path": "/data/local/myfr",
  "server_name": "aaabbb", 
  "server_port": 27042,
  "device_id": null,
  "adb_path": "adb"
}
  • server_path: Custom path for frida-server on Android device

  • server_name: Custom frida-server binary name

  • server_port: Port for Frida server communication

  • device_id: Specific device ID (null for auto-detection)

  • adb_path: Path to ADB executable

Available Tools

spawn(package_name, initial_script?, wait_seconds?, max_output_messages?)

Start an Android application with optional script injection.

attach(target, initial_script?, wait_seconds?, max_output_messages?)

Attach to a running process with optional script injection.

get_frontmost_application()

Get the currently active application.

list_applications()

List all installed applications.

Example Usage

// Hook HashMap operations
Java.perform(function() {
    var HashMap = Java.use("java.util.HashMap");
    HashMap.put.implementation = function(key, value) {
        console.log("HashMap.put:", key, value);
        return this.put(key, value);
    };
});

Related MCP server: frida-mcp

中文

一个 Model Context Protocol (MCP) 服务器,使 AI 模型能够使用 Frida 进行 Android 动态分析。

项目结构

frida-mcp/
├── frida_mcp.py          # MCP 服务器核心实现
├── pyproject.toml        # 项目依赖和配置文件
├── requirements.txt      # 传统依赖文件
├── config.json           # 可选的 Frida 服务器配置
├── README.md            # 文档说明
└── .gitignore           # Git 忽略规则

核心文件

  • frida_mcp.py: 集成 Frida 的主要 MCP 服务器

  • pyproject.toml: 现代 Python 项目配置(推荐使用)

  • requirements.txt: 传统依赖文件

  • config.json: Frida 服务器设置的可选配置文件

安装

# 克隆仓库
git clone http://git.dev.sh.ctripcorp.com/octopus/frida-mcp.git
cd frida-mcp

# 安装依赖(选择一种方法)
# 方法1:使用 pip + requirements.txt
pip install -r requirements.txt

# 方法2:使用 pip + pyproject.toml(推荐)
pip install -e .

# 在 Android 设备上设置 frida-server
adb push frida-server /data/local/tmp/
adb shell "chmod 755 /data/local/tmp/frida-server"
adb shell "su -c /data/local/tmp/frida-server &"

MCP 配置

添加到您的 MCP 客户端配置(如 Claude Desktop 配置文件):

Windows (%APPDATA%\Claude\claude_desktop_config.json):

{
  "mcpServers": {
    "frida": {
      "command": "python",
      "args": ["C:\\Users\\你的用户名\\frida-mcp\\frida_mcp.py"],
      "transport": "stdio"
    }
  }
}

注意:将 你的用户名 替换为实际的 Windows 用户名,路径使用双反斜杠 \\

macOS/Linux (~/.config/claude/claude_desktop_config.json):

{
  "mcpServers": {
    "frida": {
      "command": "python",
      "args": ["/home/用户名/frida-mcp/frida_mcp.py"],
      "transport": "stdio"
    }
  }
}

注意:将 用户名 替换为实际的系统用户名


### 配置说明(可选)

`config.json` 文件包含可选的 Frida 服务器配置:

```json
{
  "server_path": "/data/local/myfr",
  "server_name": "aaabbb", 
  "server_port": 27042,
  "device_id": null,
  "adb_path": "adb"
}
  • server_path: Android 设备上 frida-server 的自定义路径

  • server_name: frida-server 二进制文件的自定义名称

  • server_port: Frida 服务器通信端口

  • device_id: 指定设备 ID(null 为自动检测)

  • adb_path: ADB 可执行文件路径

可用工具

spawn(package_name, initial_script?, wait_seconds?, max_output_messages?)

启动 Android 应用程序,可选注入脚本。

  • package_name: 应用包名

  • initial_script: 可选的 JavaScript 脚本

  • wait_seconds: 等待输出的时间(默认 1.5 秒)

  • max_output_messages: 最大输出消息数(默认 100)

attach(target, initial_script?, wait_seconds?, max_output_messages?)

附加到运行中的进程,可选注入脚本。

  • target: 进程名或 PID

  • initial_script: 可选的 JavaScript 脚本

  • wait_seconds: 等待输出的时间(默认 1.0 秒)

  • max_output_messages: 最大输出消息数(默认 100)

get_frontmost_application()

获取当前活跃的应用程序。

list_applications()

列出所有已安装的应用程序。

使用示例

// Hook HashMap 操作
Java.perform(function() {
    var HashMap = Java.use("java.util.HashMap");
    HashMap.put.implementation = function(key, value) {
        console.log("HashMap.put:", key, value);
        return this.put(key, value);
    };
});

特性

  • 🚀 自动 Gson 对象序列化

  • 🔍 console.log 自动重定向

  • 📱 自动设备连接管理

  • 🤖 为 AI 交互优化

常见问题

Q: 应用崩溃怎么办? A: 减少 hook 频率,避免复杂序列化操作。

Q: 没有输出? A: 确认方法被调用,spawn 时脚本在应用启动前注入。

Q: 连接失败? A: 检查 frida-server 是否运行:adb shell ps | grep frida

Requirements

  • Python 3.8+

  • Android 设备 (root)

  • 查看 requirements.txt

License

MIT

F
license - not found
-
quality - not tested
D
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    -
    quality
    D
    maintenance
    An MCP-compliant server that enables AI systems to interact with mobile and desktop applications through Frida's dynamic instrumentation capabilities, allowing for process management, device control, JavaScript execution, and script injection.
    Last updated
    399
    MIT
  • A
    license
    B
    quality
    C
    maintenance
    An MCP server that enables AI-assisted mobile security testing by exposing Frida functionality for Android application research. It provides tools for hooking Java methods, manipulating memory, managing device processes, and executing custom Frida scripts.
    Last updated
    37
    15
    MIT
  • A
    license
    B
    quality
    C
    maintenance
    A comprehensive MCP server that exposes Frida's dynamic instrumentation toolkit to AI agents for process management, script injection, and memory operations. It provides over 50 tools to interact with local and mobile devices, enabling advanced capabilities like function hooking and memory analysis.
    Last updated
    55
    MIT
  • F
    license
    A
    quality
    D
    maintenance
    An AI-driven Android dynamic analysis tool that enables AI models to perform automated reverse engineering by controlling Frida. It provides capabilities to inject scripts, manage application processes, and analyze real-time execution data through the Model Context Protocol.
    Last updated
    10
    58

View all related MCP servers

Related MCP Connectors

  • MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.

  • MCP server for AI dialogue using various LLM models via AceDataCloud

  • Security scanner for MCP servers. Detect vulnerabilities, prompt injection, and tool poisoning.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/zhizhuodemao/frida-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server