Repository navigation
v0.23.1
XcodeMCPKit v0.23.1
Breaking Changes
- Remove the
xcode-mcp-proxySTDIO adapter andXcodeMCPProxyStdioAdapterlibrary API. Connect MCP clients directly to the Streamable HTTP endpoint, normallyhttp://localhost:8765/mcp. - Replace
XcodeMCPKitSelectHostandcreatesNewHostwithXcodeOpenWorkspace({path, hostIdentifier}). One headless host is shared per Xcode installation. UseXcodeListWorkspacesand itsworkspaceIdentifierfor GUI and headless operations; replace GUItabIdentifierinputs and obtain fresh handles after a new MCP session or host restart. - Replace
DeviceInteractionStartWorkspaceSessionwithDeviceInteractionStartSession({workspaceIdentifier: ...}), and useinteractionSessionKeyinstead ofinteractSessionKeyfor device follow-up calls. - Embedded server status now reports
Status.hosts, with each host's identifier, kind, state, and active request count, replacing upstream-slot health and aggregate readiness fields.
Improvements
- Keep each MCP session's scheme, run destination, and test plan separate in shared headless workspaces. Restore that session's settings before each operation and report a restoration failure instead of using another session's selection.
- Close unused headless workspace models once all session references and active requests are gone. Retire unused hosts for other Xcode installations after a five-minute grace period.
- Send request progress on its POST response stream and keep slow responses and idle streams alive. Cancel owned work when a client disconnects; a slow progress consumer does not block other requests.
- Report host processes through server snapshots and shut them down on
SIGINTorSIGTERM.
Migration Notes
- The proxy no longer imposes a request timeout by default. Set
--request-timeoutor the embeddedrequestTimeoutwhen a server deadline is required. The Swift SDK still defaults to 600 seconds, andRenderPreviewdefaults to 300 seconds. - Debug endpoints are disabled by default. Enable them with
--debug-endpointsorenablesDebugEndpointson a loopback listener. - Shared-host initialization no longer forwards
roots,sampling, orelicitationcapabilities. - Update the required ABIBridge version to 0.13.0.
- Restart the proxy and reconnect MCP clients to refresh tool definitions. See the migration guide for call and API replacements.
Full Changelog: v0.22.0...v0.23.1