XBrowser Controller - X浏览器 심층 제어 스킬

X浏览器(com.mmx.xbrowser)에 대한 완전한 리버스 엔지니어링 이해, APK 개조 능력, 그리고 내장 MCP 서버를 통한 브라우저 직접 제어 능력을 갖추고 있습니다.

404개의 네이티브 브리지 메서드, APK 개조 능력, 439개의 MCP 도구를 보유하며, HTTP를 통해 X浏览器를 직접 조작할 수 있습니다.

기능 특징

• MCP HTTP 서버를 통해 X浏览器 직접 제어

• 8개 기본 도구: 상태 조회, 탭 정보, JS 실행, HTML 가져오기, 텍스트 가져오기, 브리지 메서드 열거, 탐색, 새로고침

• 27개 고급 래퍼 도구: 시스템 정보, UI 테마, 팝업, 클립보드, 검색, UA 관리, 프록시, 읽기 모드, 미디어/TTS, 다운로드 관리, 파일 관리, 책갈피, 계정, VIP, 자동 완성, 사이트 정책, 개인정보 보호, 탭 관리, 제스처, 이벤트, QR 스캔, 공유, 확대/축소, 보안, 사용자 스크립트, 개발자 도구, 광고 차단

• 404개 네이티브 브리지 메서드 직접 호출

• LAN 직접 연결 및 ADB 터널 두 가지 연결 방식 지원

• AI 에이전트 시스템에 바로 통합 가능한 스킬 정의 파일

Related MCP server: InSite

사전 요구 사항

1. X浏览器 강화판 APK(내장 MCP HTTP 서버, 포트 8765)

2. Python 3.8+

3. 네트워크 연결(LAN 또는 ADB)

빠른 시작

1. 의존성 설치

pip install -r requirements.txt

2. X浏览器 MCP 서버 시작

X浏览器 강화판에서는 브라우저 시작 후 자동으로 포트 8765를 리스닝합니다.

MCP 서버가 실행 중인지 확인합니다:

curl -X POST http://127.0.0.1:8765/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"xbrowser_status","arguments":{}}}'

3. Python 클라이언트 사용

from xbrowser_mcp_server import XBrowserClient

# 连接 X浏览器 MCP 服务器
client = XBrowserClient("http://127.0.0.1:8765/mcp")

# 查询状态
status = client.call_tool("xbrowser_status")
print(status)

# 导航到网页
client.call_tool("xbrowser_navigate", {"url": "https://www.baidu.com"})

# 获取页面内容
html = client.call_tool("xbrowser_get_html")
print(html)

# 执行 JavaScript
result = client.call_tool("xbrowser_eval_js", {"expression": "document.title"})
print(result)

# 获取 Cookie
cookies = client.call_tool("xbridge_GM_cookie_list", {"p1": "", "p2": "", "p3": "", "p4": ""})
print(cookies)

# TTS 语音朗读
client.call_tool("xbridge_TTS", {"p1": "你好，这是语音朗读测试"})

4. 명령줄 사용

# 查询状态
python xbrowser_mcp_server.py status

# 导航
python xbrowser_mcp_server.py navigate https://www.baidu.com

# 获取页面文本
python xbrowser_mcp_server.py text

# 执行JS
python xbrowser_mcp_server.py eval "document.title"

연결 방식

LAN 직접 연결

POST http://192.168.1.5:8765/mcp
Content-Type: application/json

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"xbrowser_status","arguments":{}}}

ADB 터널(LAN이 통하지 않는 경우)

adb forward tcp:8765 tcp:8765
# 然后访问 http://127.0.0.1:8765/mcp

도구 목록

1. 기본 도구(8개)

2. 고급 래퍼 도구(27개)

각 도구는 action 매개변수로 하위 작업을 구분합니다. 시스템 정보, UI 테마, 팝업, 클립보드, 검색, UA 관리, 프록시, 읽기 모드, 미디어/TTS, 다운로드 관리, 파일 관리, 북마크, 계정, VIP, 자동 완성, 사이트 정책, 개인정보 보호, 탭 관리, 제스처, 이벤트, QR 스캔, 공유, 확대/축소, 보안, 사용자 스크립트, 개발자 도구, 광고 차단 등을 포함합니다.

3. 브리지 메서드 도구(404개)

명명 규칙: xbridge_<메서드명>, 매개변수는 순서대로 p1, p2, p3...로 전달합니다.

일반적으로 사용할 수 있는 브리지 메서드:

• xbridge_getVersionCode -> 버전 번호

• xbridge_getBrowserInfo -> 브라우저 정보

• xbridge_inChina -> 중국에 있는지 여부

• xbridge_GM_cookie_list(p1,p2,p3,p4) -> Cookie 나열(httpOnly 포함)

• xbridge_getFaviconURI(p1) -> 파비콘 가져오기

• xbridge_getElementRules(p1) -> 광고 필터링 규칙 가져오기

• xbridge_getSniffMediaResource -> 미디어 리소스 스니핑

• xbridge_TTS(p1) -> 텍스트 음성 낭독

보안 검증 설명

약 1/4의 브리지 메서드는 X8.p() 보안 검증 보호를 받으며, 다음 페이지에서만 호출할 수 있습니다:

• x:// 내부 프로토콜 페이지(예: x://settings)

• file:///android_asset/ 설정 페이지

• xbext.com 도메인

해결 방법: 먼저 xbrowser_navigate("x://settings")를 호출한 후 제한된 메서드를 실행합니다.

APK 개조 지식

도구 체인

# 编译 Java
javac -cp /opt/android-sdk/platforms/android-34/android.jar -d out com/mmbox/xbrowser/XBrowserMcpServer.java

# 转换为 DEX
java -cp /opt/android-sdk/build-tools/35.0.0/lib/d8.jar com.android.tools.r8.D8 \
  --output dex_out --lib /opt/android-sdk/platforms/android-34/android.jar \
  out/com/mmbox/xbrowser/*.class

# 反编译 DEX
java -cp /usr/share/java/baksmali.jar:... org.jf.baksmali.Main \
  disassemble -o smali_out dex_out/classes.dex

# 打包 APK
apktool b $DECODED_DIR -o output.apk

# 签名
java -jar /opt/android-sdk/build-tools/35.0.0/lib/apksigner.jar sign \
  --ks /tmp/debug.keystore --ks-pass pass:android \
  --out signed.apk unsigned.apk

# 安装
adb install -r signed.apk

변경 포인트

1. Browser.smali -> onCreate()에 getInstance() -> setContext() -> start() 주입

2. Of.smali -> 생성자에 getInstance() -> registerWebView(webView) 주입

3. X8.smali -> enableMcpServer(boolean) 및 isMcpServerEnabled() 브리지 메서드 추가

4. assets/settings/general-setting.html -> MCP 스위치 UI + JS 주입

알려진 문제

프로젝트 구조

xbrowser_controller/
├── README.md                  # 项目说明
├── LICENSE                    # MIT 许可证
├── xbrowser_mcp_server.py     # MCP 服务器客户端核心代码
├── skills.json                # 技能定义（8个预置工具）
├── requirements.txt           # Python 依赖
└── .gitignore

스킬 정의

skills.json에는 8개의 사전 설정 도구에 대한 완전한 정의가 포함되어 있으며, AI 에이전트 시스템에 바로 통합할 수 있습니다:

• X浏览器 상태 조회

• X浏览器 나비게이션

• X浏览器 검색

• X浏览器 페이지 콘텐츠 읽기

• X浏览器 Cookie 가져오기

• X浏览器 정보 가져오기

• X浏览器에서 JS 실행

• X浏览器 음성 낭독

주의사항

• 본 도구는 합법적인 보안 연구와 학습 목적으로만 사용하십시오.

• 리버스 엔지니어링 및 APK 개조 시 관련 법률과 규정을 준수하십시오.

• 본 도구 사용으로 인한 모든 결과는 사용자가 직접 부담합니다.

라이선스

MIT License