Frequently Asked Questions about XcodeBuild MCP

What is XcodeBuild MCP?

XcodeBuild MCP is a Model Context Protocol (MCP) server that provides Xcode-related tools for integration with AI assistants and other MCP clients. It enables programmatic interaction with Xcode projects through a standardized interface, optimized for agent-driven development workflows.

What are the prerequisites for using XcodeBuild MCP?

To use XcodeBuild MCP, you need macOS 14.5 or later, Xcode 16.x or later, Node 18.x or later, and optionally AXe 1.0.0 or later for UI automation.

How do I install AXe for UI automation?

You can install AXe using Homebrew with the following commands:

bash brew tap cameroncooke/axe brew install axe

How do I configure my MCP client to use XcodeBuild MCP?

You can configure your MCP client by manually editing the configuration file or by using the provided quick install links for tools like Cursor and VS Code. Alternatively, you can use mise to install and manage XcodeBuild MCP.

What is incremental build support, and how do I enable it?

Incremental build support is an experimental feature that can significantly reduce build times. To enable it, set the INCREMENTAL_BUILDS_ENABLED environment variable to true in your MCP client configuration.

How do I troubleshoot issues with XcodeBuild MCP?

If you encounter issues, you can use the diagnostic tool to check your system configuration and dependencies. Run the tool using either npx or mise, and include the output when reporting issues.

What information is sent to Sentry, and how do I opt out?

XcodeBuild MCP uses Sentry for error monitoring and diagnostics. Only error-level logs and diagnostic information are sent by default. To opt out, set the SENTRY_DISABLED environment variable to true in your MCP client configuration.

Can I enable only specific tools in XcodeBuild MCP?

Yes, XcodeBuild MCP allows selective tool registration. You can enable specific tools or groups of tools by setting the corresponding environment variables in your MCP client configuration. Refer to the TOOL_OPTIONS.md file for a list of available tools and instructions.

Where can I find the MCP server logs?

The MCP server logs are captured by the client application. For example, in Cursor, you can find the logs in the ~/Library/Application Support/Cursor/logs directory.

What is UBOS and how does it relate to XcodeBuild MCP?

UBOS is a full-stack AI Agent Development Platform that provides a centralized platform for managing AI tools and components. It enhances the utility of XcodeBuild MCP by providing seamless integration, scalability, reliability, and enhanced security.