快速开始 • Flipper Zero • 工具分类 • 使用示例 • 平台支持 • 法律

一个 MCP 统治一切，一个 MCP 找到它们，一个 MCP 编译工具，并在 God Mode 中束缚它们。🎲⚡

版本 1.7c - 独立工具安装与整合的 Flipper Zero 支持

🔢 规范工具数量

148 个工具 - 在两种服务器架构（server-refactored 和 modular）中完整实现

📚 快速导航

🚀 快速开始 - 几分钟内即可启动并运行
🌐 前端集成指南 - 适用于 Cursor、LM Studio、Claude、SillyTavern 等的设置
📋 完整工具目录 - 浏览所有 148 个已记录的工具及详细文档
🔧 参数参考 - 完整的参数文档
💻 示例与教程 - 真实世界的使用示例
🌍 平台兼容性 - 平台特定细节
📝 版本 1.7c 更新日志 - 最新更新内容

🚀 快速开始

# 1) Clone & enter
git clone https://github.com/BlinkZer0/MCP-God-Mode.git
cd MCP-God-Mode

# 2) Setup
cp .env.example .env   # edit if needed
npm install

# 3) Launch (choose one)
npm run start:refactored   # full refactored server (148 tools)
# or
npm run start:modular      # modular loader (148 tools, grouped)
# or minimal
npm run start:minimal      # minimal profile (15 core tools)

单个工具安装（新功能！）

仅安装您需要的特定工具：

# Install specific tools
node install.js --modular --tools health,system_info,fs_list

# Install with automatic dependencies
node install.js --modular --tools port_scanner --auto-deps

# Install categories + individual tools
node install.js --modular --categories core,network --tools packet_sniffer

# List all available tools
node install.js --list-tools

📖 完整独立工具安装指南

Windows (PowerShell)

.\scripts\install-win.ps1
npm run start:refactored

快速健康检查

npm run smoke

TL;DR — 什么是 MCP God Mode？

MCP God Mode 是终极网络安全与系统管理平台，在 5 大平台上提供 148 个完整实现的工具。它专为安全专业人员、系统管理员、渗透测试人员以及任何需要全面系统控制和安全测试能力的人而设计。

深入解析 — 架构与安全性

📝 注意：我们同时提供单体式和模块化服务器架构。我们的主服务器重构版在统一界面中提供全面功能，包含 148 个工具。模块化服务器提供 148 个工具（可配置），用于细粒度控制、更好的错误处理，并便于个人提取工具用于自己的服务器构建。工具位于 dev/src/tools。每种架构服务于不同的用例和偏好。

🔍 服务器架构差异：

Server-Refactored（148 个工具）：统一服务器，包含所有核心端点以及增强端点（Flipper Zero 套件 + MCP Web UI Bridge + 高级工具）。包含内置法律合规、审计日志和取证就绪能力。
Modular Server（148 个工具，可配置）：综合架构，包含 148 个工具，用于细粒度控制、更好的错误处理和专门功能。可配置 - 可设置为加载最小（10 个工具）、自定义类别或完整（148 个工具）。完整法律合规集成，支持模块化证据保全。
Server-Minimal（15 个工具）：轻量级实现，仅包含核心工具，用于基本功能和资源受限环境。

🔢 工具数量说明：

148 个工具注册在 server-refactored 和 server-modular 中（完整实现）
15 个工具注册在 server-minimal 中（仅核心工具）

📊 文档状态：所有 148 个工具（两个服务器）现在都有全面文档，包含详细使用示例、参数参考和平台兼容性信息。有关每个工具的详细信息，请参阅完整工具目录。

⚖️ 法律合规与取证就绪：两种服务器架构都包含全面的法律合规能力，包括审计日志、证据保全、法律保留管理和监管链跟踪。这些功能默认禁用，可通过环境变量启用，以符合 SOX、HIPAA、GDPR、PCI DSS 和 ISO 27001 合规要求。有关详细配置和使用说明，请参阅法律合规文档。

安全与合规模式

标志	默认值	效果（摘要）
MCPGM_AUDIT_ENABLED	true	将工具调用 + 参数记录到审计日志。
MCPGM_REQUIRE_CONFIRMATION	true	高风险操作前提示确认。
MCPGM_MODE_SOX	false	额外日志记录与保留指导。
MCPGM_MODE_HIPAA	false	禁用 PHI 不安全工具；更严格的脱敏。
MCPGM_MODE_GDPR	false	被遗忘权辅助；数据最小化。

⚠️ 威胁模型 / 安全使用通知：此工具仅用于授权测试和安全评估。仅可在您拥有或已获得明确书面许可测试的网络和系统上使用。默认启用审计日志；高风险工具需要确认。禁止针对政策适用于所有操作。

🐬 Flipper Zero 集成

注意：请先在受控环境中运行。请参阅免责声明。

MCP-God-Mode 包含全面的 Flipper Zero 集成，跨平台支持 USB CDC Serial 和 BLE GATT 传输。单个整合工具 flipper_zero 在两种服务器模式下提供所有 Flipper Zero 操作。

完整文档请参阅 docs/tool/flipper_zero.md。

🔧 设置

启用 Flipper 集成：

# Copy environment template
cp dev/flipper.env.example .env

# Edit .env to enable Flipper Zero
MCPGM_FLIPPER_ENABLED=true
MCPGM_FLIPPER_USB_ENABLED=true
MCPGM_FLIPPER_BLE_ENABLED=true

安装依赖项：
```
cd dev
npm install
```

启动服务器：

npm run start:refactored
# or
npm run start:modular

🚀 快速示例

列出可用设备：

// List all Flipper Zero devices (USB and BLE)
flipper_zero({\n  action: "list_devices",\n  scan_ble: true,\n  scan_usb: true,\n  include_bridge: true\n})

连接并获取设备信息：

// Connect to device
const connectResult = flipper_zero({\n  action: "connect",\n  device_id: "usb:/dev/tty.usbmodem123"\n})

// Get device information
const info = flipper_zero({\n  action: "get_info",\n  session_id: connectResult.sessionId\n})

文件操作：

// List files in root directory
flipper_zero({\n  action: "fs_list",\n  session_id: sessionId,\n  path: "/"\n})

// Read a file
flipper_zero({\n  action: "fs_read",\n  session_id: sessionId,\n  path: "/ext/ir/remote.ir"\n})

最受欢迎

MCP-God-Mode