nanshanyi/dsh-mcp-xcode

README excerpt

dsh-mcp-xcode DeepSeek Harness (DSH) 插件:把 Xcode Headless MCP ( xcrun mcpbridge )桥接为 DSH 原生工具。 装上之后,DSH agent 就能直接调用 Xcode 的全部 headless 能力:创建/打开工程、构建、测试、渲染 SwiftUI Preview 为 PNG、启动模拟器并交互(tap/type/swipe)、读截图与无障碍层级、读 OSLog 等 —— 无需打开 Xcode UI。 安装 一条命令(官方插件通道, dsh plugin 转发给 pnpm,支持 npm / GitHub / 本地路径): 本包通过 dsh.bundle.patch 自描述挂载:安装后 无需编辑任何 profile 文件 ,重启 DSH 即生效(设置 → 插件列表可见, xcode 工具对所有会话可用)。 如果你之前手动在 cordis.patch.yml 里写过本插件的行,请先删掉,避免双挂载。 前置条件(macOS + Xcode 27+) 要求 Xcode 27 或更高 (headless MCP 从 Xcode 27 beta 5 起内置 xcrun mcp-server / mcpbridge ,更早版本没有这些命令;本项目在 27.0 27A5237l 上开发验证): 首次连接会弹 Xcode agent 授权框,批准一次即可。DSH 是签名应用,授权 永久有效 ;未签名客户端则约 24 小时过期。 构建报 Operation not permitted 时,给 headless 服务授权工程所在文件夹(需 sudo): sudo xcrun mcp-server allow-folder /path/to/your/projects 原理 插件通过 subprocess 服务 spawn /usr/bin/xcrun mcpbridge ,在 stdio 上自行实现 MCP(JSON-RPC 2.0)客户端: 1. initialize (protocolVersion 2025-06-18 )→ notifications/initialized → tools/list ; 2. 把 tools/list 返回的每个工具(实测 Xcode 27 = 54 个 )的 JSON Schema 转成 DSH 参数 DSL,注册为 xcode 工具; 3. 工具调用转发为 tools/call ,文本内容聚合进结果;截图自动存入 attachment 并通过 deferContext 注入下一轮模型上下文; 4. 附带控制工具 xcode mcp status :查看连接状态 / 强制重连 / 查看 bridge stderr。 使用 直接自然语言描述即可,例如: 打开 /pa…

Category