Licence
MIT
Version
1.0.0
Deps
1
Size
48 kB
Vulns
0
Weekly
0
iOSExplore MCP Server
Mac 本机运行的 MCP stdio server。它把 App 内 ExploreServer 的 POST / action 包装成 MCP tools,默认连接 http://localhost:38321/。
启动前提
模拟器:App 启动并开启 IOS_EXPLORE_AUTOSTART=1 后,Mac 直接访问 localhost:38321。
真机:App 启动并开启 IOS_EXPLORE_AUTOSTART=1 后,先启动 iproxy 38321 38321。真机验收前运行:
lsof -iTCP:38321 -sTCP:LISTEN
COMMAND 必须是 iproxy,不能是残留的 SPMExampl。
开发命令
npm install
npm test
npm run typecheck
npm run build
配置
| 环境变量 | 默认值 | 说明 |
|---|---|---|
IOS_EXPLORE_BASE_URL |
http://localhost:38321/ |
iOSExplore HTTP 地址 |
IOS_EXPLORE_REQUEST_TIMEOUT_MS |
10000 |
普通 action 请求超时 |
ui.wait、ui.waitAny、wait_and_inspect 会按业务 timeoutMs + 5000 自动放宽 HTTP timeout。
端到端测试
- 完整端到端流程文档:docs/investigations/mcp-e2e-test.md
- 本地临时调试(不安装 iOSDriver 到任何 MCP 客户端):docs/local-mcp-test.md