AI导哈

Android日志分析工具

FadCat是一款轻量级、功能丰富的跨平台Android日志分析工具，支持GUI、CLI和MCP服务器模式，适用于Android调试和设备检查。

  • by anonfaded
  • Python
  • 本地部署
  • 16 星标
  • 更新于
在 GitHub 查看 anonfaded/FadCat

使用说明

>_ FADCAT

FadCat是Android Studio的轻量级、功能丰富、跨平台的Android logcat替代品，没有臃肿。它将ADB捆绑在支持的架构中，并在GUI、CLI或MCP服务器模式下运行。

>_ 📱 截图


Main FadCat GUI window
Multi-device logcat, color-coded logs, and search

Package picker
Quickly filter and select app packages
Settings
Customize logcat display, ignored tags, and UI options

MCP server
Automation, device/media inspection, and FadCam integration
Advanced customization
Tailor FadCat to your workflow

[！提示] 该项目是 FadSec实验室套件.
了解我们对无广告、隐私优先的应用程序的关注，并随时了解未来的版本！

FadCat也发货 专业的FadCam媒体工具 浏览并提取FadCam媒体进行备份。
FadCam存储库： FadCam

⭐ 来自FadSec实验室套件：
此外，请查看我们的桌面应用程序/文件/文件夹储物柜： FadCrypt

>_ 特性

  • 多设备日志会话：每个设备/会话的专用选项卡
  • 按模式搜索：正则表达式、模糊搜索、grep模式和案例切换
  • 高亮：比赛以清晰的当前比赛焦点突出显示
  • 日志级芯片：立即按V/D/I/W/E/F过滤
  • 包裹选取器：可搜索的包列表，用于快速定位
  • 视觉清晰度：彩色日志级别/标签和可读的UI默认值
  • 可定制的：通过设置填充标记、忽略标记和UI选项
  • 捆绑亚洲开发银行：架构感知选择，不依赖系统ADB
  • MCP服务器：AI助手可以检查设备、日志、进程和媒体
  • FadCam集成：浏览并提取FadCam媒体进行备份
  • 跨平台实用程序：macOS、Linux和Windows

>_ FadCat的用途是什么

FadCat专为快速的日常Android调试而设计：通过MCP进行logcat探索、设备检查和结构化AI工作流程。
这也是一个 FadCam的专业伴侣，用于浏览和管理FadCam媒体，并将备份拉到您的PC上。

有很多logcat包装器，但大多数都是CLI繁重的，对于日常工作来说感觉太手动了。
FadCat添加了一个干净、功能丰富的GUI，其中包含易于使用的选项。

>_ 模式

>_ GUI（默认）

fadcat

>_ 命令行界面

fadcat --cli

>_ MCP服务器（stdio）

fadcat --mcp

>_ MCP概述

FadCat公开了一个FastMCP服务器，以便AI助手可以使用FadCat的MCP工具。

核心MCP功能

  • 设备发现和系统信息
  • Logcat流媒体和搜索
  • 应用程序流程检查
  • FadCam媒体浏览和选择性拉取

路线图方向 FadCat MCP正在向更自主的Android工作流程发展。规划区域包括：

  • 设备自动化和捕获流程（例如，与scrcpy等开源工具集成）
  • APK级检查和逆向工程助手
  • 更丰富的设备诊断和自动调试程序

>_ MCP设置（IDE）

推荐：OpenCode（免费）

  1. 运行： opencode mcp add
  2. 用途：
    • 姓名： fadcat
    • 类型： local
    • 命令： fadcat
    • Args： --mcp

手动配置（其他AI工具） 在IDE设置中添加以下MCP配置之一：

已安装（推荐）

{
  "fadcat": {
    "type": "stdio",
    "command": "fadcat",
    "args": ["--mcp"],
    "env": {"PYTHONUNBUFFERED": "1"}
  }
}
Local Dev (run from source) 
{
  "fadcat": {
    "type": "stdio",
    "command": "/opt/homebrew/bin/python3",
    "args": ["-m", "src.mcp"],
    "env": {
      "PYTHONUNBUFFERED": "1",
      "PYTHONPATH": "/path/to/FadCat"
    }
  }
}

笔记：

  • 替换 command 使用Python路径从 which python3.
  • 替换 PYTHONPATH 使用您克隆FadCat仓库的路径。

在macOS上，CLI命令在首次启动时注册。

>_ MCP提示示例

>_ FadCam MCP

  • Browse FadCam beta camera recordings in internal storage.
  • Browse FadCam Pro+ recordings on the SD card.
  • Browse FadCam media and tell me total videos and space used.
  • Browse the forensic gallery, then pull the latest 5 forensic snapshots.
  • Pull this exact file: FadCam_YYYYMMDD_HHMMSS.mp4

>_ 通用MCP

  • Summarize the latest logcat warnings and errors.
  • Analyze app crash logs and suggest the root cause.
  • List connected devices and show device details.
  • Show system info and storage stats for the selected device.

>_ ⬇️ 下载

从下载最新版本 发布页面.

>_ 加入社区

加入我们 Discord 服务器 分享想法、寻求帮助或与其他用户联系。欢迎您的反馈和贡献！

>_ 支持与购物

通过Patreon支持开发。

Contributing and Requirements

贡献

  • 先打开一个问题来讨论功能或修复。
  • 分叉仓库并创建一个功能分支。
  • 以明确的信息提交您的更改。
  • 打开一个pull请求并链接相关问题。

需求

  • Python 3.8+（在Python 3.14上构建和测试）
  • 依赖关系 requirements.txt

Dev快速启动

pip3 install -r requirements.txt
python3 FadCat.py

为生产而建

平台 命令
视窗 powershell -ExecutionPolicy Bypass -File .\build\windows\build.ps1
macOS bash build/macos/build.sh
Linux bash build/linux/build.sh

>_ 学分

>_ 许可证

Apache 2.0

相关 MCP