xcodeproj-mcp-server

What is xcodeproj-mcp-server?

A Model Context Protocol (MCP) server for programmatically manipulating Xcode project files (.xcodeproj) using Swift. It integrates with the tuist/xcodeproj library and the Swift MCP SDK, enabling AI assistants and other MCP clients to create, inspect, and automate Xcode projects without opening Xcode.

How to use xcodeproj-mcp-server?

Install via Docker: docker pull ghcr.io/giginet/xcodeproj-mcp-server. Configure for Claude Code with claude mcp add xcodeproj -- docker run --pull=always --rm -i -v $PWD:/workspace ghcr.io/giginet/xcodeproj-mcp-server:latest /workspace. For Claude Desktop, add a JSON entry to claude_desktop_config.json that runs the Docker container with the project directory mounted. The server supports path restriction to a base directory for security.

Key features of xcodeproj-mcp-server?

• Create new Xcode projects programmatically
• Manage targets, files, and build configurations
• Inspect project groups and hierarchies
• Add dependencies, frameworks, and Swift Packages
• Support for app extensions (widgets, etc.)
• Automate common Xcode development tasks

Use cases of xcodeproj-mcp-server?

• Create multi‑target projects from scratch without Xcode
• Automatically add new source files to appropriate targets
• Integrate build phases for linters and custom scripts
• Set up build configurations and Info.plist settings
• Add Widget Extensions and other app extensions automatically

FAQ from xcodeproj-mcp-server

What are the runtime requirements?

Docker and macOS are required. The server runs inside a Docker container and must access Xcode project files stored on the host.

How does the server access my project files?

You mount a host directory (e.g., `