Xcode: MCP Bridge Wrapper for Cursor
soundblaster/xcodemcpwrapper
If you're trying to use Xcode 26.3's MCP bridge with Cursor and hitting spec compliance errors, this wrapper is the fix. Apple's mcpbridge returns tool responses in the content field but skips the required structuredContent field when outputSchema is declared. Claude and Codex have workarounds baked in, but Cursor strictly follows the MCP spec and rejects the responses. This Python wrapper sits between your client and mcpbridge, intercepts the non-compliant responses, and copies content into structuredContent so everything works. It also includes a broker mode that maintains one persistent upstream session to reduce reconnection overhead, which helps with the repeated connection dialogs documented in Xcode 26.4 release notes.
- tools
- 54
- transport
- STDIO
- last updated
- Sep 22, 2026
Tools
54 toolsPublic tool metadata for what this MCP can expose to an agent.
XcodeListWorkspacesLists workspaces so the agent can inspect them after Xcode approval.
Lists workspaces so the agent can inspect them after Xcode approval.
No parameter schema in public metadata yet.
XcodeOpenWorkspaceOpens an existing .xcodeproj or .xcworkspace to request access.
Opens an existing .xcodeproj or .xcworkspace to request access.
No parameter schema in public metadata yet.
XcodeCloseWorkspace
No parameter schema in public metadata yet.
XcodeNewProject
No parameter schema in public metadata yet.
XcodeNewTarget
No parameter schema in public metadata yet.
XcodeListTargets
No parameter schema in public metadata yet.
XcodeListTemplates
No parameter schema in public metadata yet.
XcodeListSchemes
No parameter schema in public metadata yet.
XcodeSwitchScheme
No parameter schema in public metadata yet.
XcodeListRunDestinations
No parameter schema in public metadata yet.
XcodeSwitchRunDestination
No parameter schema in public metadata yet.
XcodeListTestPlans
No parameter schema in public metadata yet.
XcodeSwitchTestPlan
No parameter schema in public metadata yet.
XcodeRead
No parameter schema in public metadata yet.
XcodeWrite
No parameter schema in public metadata yet.
XcodeUpdate
No parameter schema in public metadata yet.
XcodeLS
No parameter schema in public metadata yet.
XcodeGlob
No parameter schema in public metadata yet.
XcodeGrep
No parameter schema in public metadata yet.
XcodeMakeDir
No parameter schema in public metadata yet.
XcodeMV
No parameter schema in public metadata yet.
XcodeRM
No parameter schema in public metadata yet.
XcodeRefreshCodeIssuesInFile
No parameter schema in public metadata yet.
BuildProject
No parameter schema in public metadata yet.
GetBuildLog
No parameter schema in public metadata yet.
GetTestList
No parameter schema in public metadata yet.
RunAllTests
No parameter schema in public metadata yet.
RunSomeTests
No parameter schema in public metadata yet.
RunProject
No parameter schema in public metadata yet.
StopProject
No parameter schema in public metadata yet.
GetConsoleOutput
No parameter schema in public metadata yet.
InvokeDebuggerCommand
No parameter schema in public metadata yet.
GetFileCompilerFlags
No parameter schema in public metadata yet.
UpdateFileCompilerFlags
No parameter schema in public metadata yet.
GetTargetBuildSettings
No parameter schema in public metadata yet.
UpdateTargetBuildSetting
No parameter schema in public metadata yet.
DeviceInteractionStartSession
No parameter schema in public metadata yet.
DeviceInteractionStartWorkspaceSession
No parameter schema in public metadata yet.
DeviceInteractionInstallAndRun
No parameter schema in public metadata yet.
DeviceInteractionSynthesize
No parameter schema in public metadata yet.
DeviceInteractionEndSession
No parameter schema in public metadata yet.
LocalizationPlanner
No parameter schema in public metadata yet.
StringCatalogContext
No parameter schema in public metadata yet.
StringCatalogRead
No parameter schema in public metadata yet.
StringCatalogEdit
No parameter schema in public metadata yet.
GetTopCrashIssues
No parameter schema in public metadata yet.
GetCrashIssueLogs
No parameter schema in public metadata yet.
GetTopFieldPerformanceIssues
No parameter schema in public metadata yet.
GetFieldPerformanceIssueLogs
No parameter schema in public metadata yet.
RenderPreview
No parameter schema in public metadata yet.
DocumentationSearch
No parameter schema in public metadata yet.
RunCodeSnippet
No parameter schema in public metadata yet.
AddEntitlement
No parameter schema in public metadata yet.
AddInfoPlist
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageReadme
Xcode MCP Bridge Wrapper
mcpbridge-wrapper connects external MCP clients to Xcode through Apple's
xcrun mcpbridge. It repairs Xcode tool responses that declare an
outputSchema but omit structuredContent. The repair works in both direct
and broker modes. Broker mode also lets several clients share one persistent
Xcode connection, reducing repeated connection prompts.
Compatibility
Details
- Repository
- github.com/soundblaster/xcodemcpwrapper
- Website
- github.com/SoundBlaster/XcodeMCPWrapper
- Category
- Mobile Development
- Package
mcpbridge-wrapper- Transport
- STDIO
- Registry
- MCP registry, active
