xcode

The Xcode MCP Server exposes a range of programmatic tools that let an AI assistant or automation orchestrate Xcode projects from creation through deployment. It provides capabilities to create new Xcode projects with SwiftUI templates, build projects, run tests, archive applications for distribution, and manage project schemes. It also offers file operations such as writing Swift files, modifying Info.plist entries, creating directories, and reading files. In addition, the server can manage iOS/macOS simulators—listing available simulators, booting or shutting them down, installing and launching apps, and capturing screenshots. When integrated with Claude Desktop or similar tooling, you can invoke dedicated commands like xcode_create_project, xcode_build_project, xcode_test_project, xcode_archive_project, and xcode_list_simulators to perform these tasks programmatically.

Prerequisites:

• macOS with Xcode installed and the Xcode command line tools
• Node.js 16.x or higher
• Git

Installation steps:

1. Clone the MCP server repository:

git clone https://github.com/yourusername/xcode-mcp.git
cd xcode-mcp

2. Install dependencies:

npm install

3. Build the project (if applicable):

npm run build

4. Run the server in development or production mode:

npm run dev

5. Configure Claude Desktop to point to the MCP server using the provided path to dist/index.js in the configuration.

{"mcpServers": {"xcode-mcp": {"command": "node", "args": ["/path/to/xcode-mcp/dist/index.js"], "env": {}}}}

Environment tips:

• Ensure Xcode and its command line tools are installed and accessible from the shell used to run the MCP server.
• If simulators do not appear, run xcode-select --install and verify Xcode command line tools availability.
• Check logs for issues at the configured log location (e.g., ~/Library/Logs/Claude/mcp-server-xcode-mcp.log) and restart Claude Desktop after configuration changes.
• The MCP server relies on macOS permissions for filesystem and simulator access; ensure adequate user permissions.
• You can customize environment variables in the mcp_config to pass API keys, paths, or feature flags as needed.