MMCPMarkets
XS

xinghelee/sandboxserver

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

31 stars 2 forks Качество 74 Тренд 15MIT
Repository Install

DEBUG-только iOS SDK, который встраивает сервер HTTP + WebSocket в ваше приложение: консоль браузера + мост MCP для проверки файлов, баз данных, сети, журналов и экрана в реальном времени. Нулевая зависимость от третьих лиц.

Обзор

[[Т0]] Это превращает любое приложение в просматриваемую цель отладки. Интегрируйте его, позвоните в Start(), и из браузера в той же сети вы получите: — . — list / preview / edit / download / delete, Range streaming, root-confined () — . — каждый запрос URLSession, проверяемый в режиме реального времени () — . — Discover SQLite DBs, просмотр таблиц / схем, запуск только для чтения SQL (; Core Data / Realm + пишет позже) — . — потоковая передача вывода консоли приложения (SandboxServer).

Обзор (машинный перевод)

** Английский ** * 中

[[Т0]]

Debug-only iOS SDK, который превращает любое приложение в объект для отладки. Интегрируйте, звоните start(), и из браузера в той же сети вы получаете:

  • ) Sandbox file browser - list / preview / edit / download / delete, Range streaming, root-confined (live) ** Захват живой сети** — каждый запрос URLSession, который можно проверить в режиме реального времени (live)
  • )Database viewer - откройте SQLite DB, просмотрите таблицы/схему, запустите только для чтения SQL (live; Core Data/Realm + пишет позже)
  • s **Живые журналы ** - потоковая передача вывода консоли приложения (SandboxServer.log, плюс print/NSLog при включении захвата консоли) в браузер, фильтрованный по уровню (live)
  • Зеркало экрана + управление - смотрите пользовательский интерфейс приложения в браузере и приводите его в действие: нажмите (кнопки UIControls / SwiftUI), swipe/scroll & drag (настоящее синтезированное касание), введите и вставьте (live, iOS) **Вид иерархии ** — проверьте дерево просмотра в реальном времени (кадры, классы, ярлыки, миниатюры) в качестве списка или **3D-эксплуататора ** в браузере (live, iOS)

Эта страница переведена автоматически. Технические детали смотрите в оригинале.

README

Показан фрагмент оригинального README. Открыть оригинал.

SandboxServer

English · 简体中文

https://github.com/user-attachments/assets/1f2cda8f-da85-492a-ac19-24ed8d34d778

A DEBUG-only iOS SDK that turns any app into a browsable debug target. Integrate it, call start(), and from a browser on the same network you get:

  • 🗂 Sandbox file browser — list / preview / edit / download / delete, Range streaming, root-confined (live)
  • 🌐 Live network capture — every URLSession request, inspectable in real time (live)
  • 🗄 Database viewer — discover SQLite DBs, browse tables/schema, run read-only SQL (live; Core Data/Realm + writes later)
  • 📜 Live logs — stream the app’s console output (SandboxServer.log, plus print/NSLog when console capture is on) to the browser, level-filtered (live)
  • 📱 Screen mirror + control — watch the app’s UI live in the browser and drive it: tap (UIControls / SwiftUI buttons), swipe/scroll & drag (real synthesized touch), type, and paste (live, iOS)
  • 🌳 View hierarchy — inspect the live view tree (frames, classes, labels, thumbnails) as a list or a 3D layer explorer in the browser (live, iOS)
  • 🔌 WebSocket capture — every URLSessionWebSocketTask connection and its sent/received frames, streamed live (live)
  • 📈 Performance HUD — live FPS / CPU / memory footprint / thermal state, streamed and charted (live)
  • 📦 App bundle inspector — Info.plist, Mach-O architectures + hardening, provisioning, privacy, plist decode (live)
  • ⚙️ UserDefaults editor — browse, edit, delete & reset the app’s persisted defaults and App Group suites (live)
  • 📲 Device info — model / OS / locale / screen + safe-area / battery / memory / free disk at a glance (live)
  • ⛓️ Deep-link trigger — list the app’s URL schemes and open any scheme / universal link in the app (live, iOS)
  • 🔔 Notification tester — inspect/request authorization, fire local notifications, simulate a remote push payload (live, iOS)
  • 🖥 A web console served by the SDK itself — no app to install, just open a URL
  • 🤖 MCP tools — the same on-device API re-exposed to AI clients (Claude Code / Desktop)

It runs an embedded HTTP + WebSocket server inside the host process on Apple’s Network.framework, with zero third-party runtime dependencies.

⚠️ This SDK exposes full read/write access to the host app’s sandbox. It is off by default, requires an explicit start(), binds loopback by default, and is physically absent from Release/App Store builds. Token auth is opt-in; if you bind to .localNetwork without enabling it, every device on the trusted LAN can reach the console. Use non-production accounts on a trusted network.

Architecture

┌─ host iOS app (DEBUG) ──────────────────────────────┐
│  SandboxServer.shared.start()                        │
│     │                                                │
Открыть полный README на GitHub

Установка

npx -y sandbox-mcp
Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{ "mcpServers": { "sandbox": { "command": "npx", "args": ["-y", "sandbox-mcp"], "env": { "SANDBOX_HOST": "127.0.0.1", "SANDBOX_PORT": "8080" } } } }