AI Agent Hub
Back to plugins
🖥️

dsh-mcp-xcode

Client Updated 2026.08.15

Run the following command in DeepSeek Harness:

dsh plugin install nanshanyi/dsh-mcp-xcode

Paste the following prompt into your AI chat to install this plugin:

Run dsh plugin install nanshanyi/dsh-mcp-xcode in the DeepSeek Harness terminal to install; source code is available at https://github.com/nanshanyi/dsh-mcp-xcode . Restart DSH and the xcode_* tools become available automatically.

About this plugin

On macOS, many developers already rely on AI agents for day-to-day coding, yet the moment a task involves Xcode project operations—building, running tests, rendering SwiftUI Previews, tapping and typing in a simulator—they hit a wall. dsh-mcp-xcode bridges the Headless MCP interface built into Xcode 27+ into native DSH tools, so the agent can drive xcrun mcpbridge directly with no Xcode UI required.

Once installed, the agent gains 54 xcode_* tools spanning project creation and opening, compilation, unit-test execution, SwiftUI Preview-to-PNG rendering, simulator launch with tap / type / swipe interaction, screenshot and accessibility-tree retrieval, and OSLog capture. The plugin includes automatic bridge self-healing: if the mcpbridge process crashes, the next tool call reconnects and re-syncs registrations without manual intervention. The xcode_mcp_status control tool lets you inspect connection state, force a reconnect, or inspect bridge stderr at any time. Optional includeTools / excludeTools filters let you narrow the tool set by name pattern to reduce schema overhead in the model context.

Ideal for iOS / macOS developers using DeepSeek Harness on macOS with Xcode 27 or later, especially those who want the agent to complete a full build-test-simulator verification loop without constantly switching windows. Signed applications receive a one-time permanent authorization; the plugin publishes no services and never modifies Xcode permission storage. Disabling the plugin terminates the child process immediately, keeping the security boundary clean.

Use Cases

  • Have the agent build an Xcode project, run unit tests, and list failures
  • Drive tap, type, and swipe interactions in the simulator and read screenshots
  • Render SwiftUI Previews to PNG for agent layout inspection

Best For

  • Developers using DSH on macOS with Xcode 27+
  • iOS engineers who want the agent to own the full build-test-verify loop
  • Teams needing headless Xcode project operations without manual window switching