MCP Ldplayer

mcp ldplayer

通过LDPlayer模拟器进行Android渗透测试的MCP服务器

  

______________________________________________________________________

这是什么？

A. 模型上下文协议（MCP） 将LDPlayer Android模拟器转换为完整渗透测试工作站的服务器。它暴露了 38工具 人工智能助手（Claude、Copilot等）可以通过自然语言调用来控制模拟器、运行ADB命令和执行Android安全评估。

零外部依赖。 纯Python 3.10+标准库。只需安装并运行。

______________________________________________________________________

建筑

┌──────────────────────────────────────────────────────────┐
│                    AI Assistant (Claude, Copilot)         │
│                         ▼ MCP Protocol (stdio)           │
├──────────────────────────────────────────────────────────┤
│                    mcp-ldplayer Server                    │
│  ┌─────────────┐  ┌──────────────┐  ┌────────────────┐  │
│  │ LD Controller│  │Pentest Toolkit│  │  Frida Scripts │  │
│  │  (ldconsole) │  │  (22 tools)  │  │  (6 built-in)  │  │
│  └──────┬───────┘  └──────┬───────┘  └────────────────┘  │
│         │                 │                               │
│         ▼                 ▼                               │
│  ┌─────────────────────────────┐                         │
│  │    LDPlayer 9 (ldconsole)   │                         │
│  │         + ADB 34.x          │                         │
│  └──────────┬──────────────────┘                         │
│             ▼                                            │
│  ┌─────────────────────────────┐                         │
│  │   Android Emulator Instance │                         │
│  │   (ARM/x86, rooted, ADB)   │                         │
│  └─────────────────────────────┘                         │
└──────────────────────────────────────────────────────────┘

______________________________________________________________________

特性

仿真器管理（9个工具）

ADB命令（7个工具）

最顶级的阿森纳（22工具）

内置Frida脚本

______________________________________________________________________

安装

先决条件

• Python 3.10+
• LDPlayer 9 已安装（在公共路径上自动检测）
• 视窗 （LDPlayer仅适用于Windows）

设置

# Clone
git clone https://github.com/ThiagoFrag/mcp-ldplayer.git
cd mcp-ldplayer

# Install (optional, can run directly)
pip install -e .

在VS代码中配置

添加到您的 .vscode/mcp.json:

{
    "mcpServers": {
        "pt-ldplayer": {
            "command": "python",
            "args": ["path/to/mcp-ldplayer/mcp_ldplayer/mcp_server.py"]
        }
    }
}

或者，如果通过pip安装：

{
    "mcpServers": {
        "pt-ldplayer": {
            "command": "mcp-ldplayer"
        }
    }
}

在Claude桌面中配置

添加 claude_desktop_config.json:

{
    "mcpServers": {
        "pt-ldplayer": {
            "command": "python",
            "args": ["C:/path/to/mcp-ldplayer/mcp_ldplayer/mcp_server.py"]
        }
    }
}

______________________________________________________________________

用法

通过AI助手

配置后，自然地问：

“列出我的LDPlayer实例”

“在com.example.app上运行完整的安全评估”

“使用SSL旁路在10.0.2.2:8080上设置Burp Suite代理”

“这款模拟器冒充三星Galaxy S21”

“捕获网络流量60秒并下载pcap”

“Fuzz导出了com.target.app的所有意图”

通过CLI

# List all 38 tools
python -m mcp_ldplayer.mcp_server --list-tools

# Run as MCP server (stdio)
python -m mcp_ldplayer.mcp_server

# Specify LDPlayer path manually
python -m mcp_ldplayer.mcp_server --ldplayer-path "D:\LDPlayer\LDPlayer9"

通过Python

from mcp_ldplayer import LDController, PentestToolkit

# Auto-detect LDPlayer
ld = LDController()

# List instances
for instance in ld.list_instances():
    print(f"{instance.name}: {instance.status}")

# Pentest toolkit
pt = PentestToolkit(ld)

# Device reconnaissance
recon = pt.device_recon("LDPlayer")

# Security assessment
audit = pt.security_assessment("LDPlayer", "com.target.app")

# SSL bypass
bypass = pt.inject_frida_script("LDPlayer", "ssl_bypass", "com.target.app")

______________________________________________________________________

最重要的工作流程

完整应用程序评估

1. pt_recon          → Device info + security posture
2. pt_apk_analyze    → Permissions, components, risk
3. pt_security_assessment → Drozer-style audit
4. pt_intent_fuzz    → Test exported activities
5. pt_deeplink_test  → Test URI schemes
6. pt_logcat         → Check for sensitive data leaks
7. pt_filesystem     → Analyze app data directory

交通拦截

1. pt_proxy_setup    → Configure Burp/mitmproxy
2. pt_cert_install   → Install CA cert in system store
3. pt_ssl_bypass     → Bypass SSL pinning
4. pt_traffic_start  → Start packet capture
5. [interact with app]
6. pt_traffic_stop   → Download pcap for Wireshark

隐身模式

1. pt_spoof_device   → Change IMEI, MAC, model
2. pt_root_bypass    → Hide root from apps
3. pt_gps_spoof      → Fake location
4. pt_frida_inject anti_debug → Bypass debugger detection

______________________________________________________________________

MCP资源

MCP提示

______________________________________________________________________

项目结构

mcp-ldplayer/
├── mcp_ldplayer/
│   ├── __init__.py          # Package exports
│   ├── ld_controller.py     # LDPlayer interface (ldconsole + ADB)
│   ├── pentest_toolkit.py   # Pentest arsenal (22 tools)
│   └── mcp_server.py        # MCP protocol server (38 tools)
├── frida_scripts/
│   ├── ssl_bypass.js        # SSL Pinning bypass
│   ├── root_bypass.js       # Root detection bypass
│   ├── keylogger.js         # Input monitoring
│   ├── crypto_hook.js       # Crypto + SharedPrefs interception
│   ├── network_hook.js      # HTTP/HTTPS monitoring
│   └── anti_debug.js        # Anti-debug bypass
├── examples/
│   ├── quick_test.py        # Quick connectivity test
│   ├── pentest_workflow.py  # Full pentest example
│   └── intercept_setup.py   # Traffic interception setup
├── tests/
│   ├── test_controller.py   # LDController unit tests
│   ├── test_toolkit.py      # PentestToolkit unit tests
│   └── test_mcp_protocol.py # MCP protocol compliance tests
├── pyproject.toml
├── requirements.txt
├── LICENSE
└── README.md

______________________________________________________________________

LDPlayer路径自动检测

服务器按顺序搜索这些路径：

1. C:\LDPlayer\LDPlayer9
2. C:\LDPlayer\LDPlayer4.0
3. C:\Program Files\LDPlayer\LDPlayer9
4. C:\Program Files (x86)\LDPlayer\LDPlayer9
5. %LOCALAPPDATA%\LDPlayer\LDPlayer9
6. D:\LDPlayer\LDPlayer9

覆盖 --ldplayer-path 如果安装在其他地方。

______________________________________________________________________

协议遵从

根据MCP规范进行测试 2024-11-05:

______________________________________________________________________

安全通知

此工具专为 仅限授权安全测试。负责任地使用，仅在您有权测试的系统上使用。作者不对误用负责。

______________________________________________________________________

许可证

麻省理工学院

______________________________________________________________________

作者

蒂亚戈弗拉格 -