xcodeproj

xcodeproj-mcp-server is an MCP server that provides tooling for programmatically manipulating Xcode project files (.xcodeproj) using a Swift-based implementation built on top of tuist/xcodeproj and the swift-sdk. It exposes a set of MCP commands to create projects, manage targets and files, modify build settings, and automate common tasks in Xcode projects. The server is designed to be consumed via MCP clients (such as Claude) and can be run locally in a Docker container or wired into your Claude Desktop/Claude Code workflows.

To use it, you typically run the server inside a container and mount your workspace so the MCP client can operate on your Xcode projects. Tools are organized by capability and include project management (create, list targets, list build configurations, list files/groups), file operations (add/remove/move files, add synchronized folders, create groups), and comprehensive build/configuration management (add targets, remove/duplicate targets, add dependencies, add app extensions, and manage build settings and frameworks). When combined with Claude, you can dynamically load these tools and invoke them in natural language prompts, enabling automated project manipulation from your AI assistant.

Prerequisites

• Docker is installed on your machine
• macOS is used for running Xcode projects (recommended for full compatibility)

Installation steps

1. Pull the pre-built Docker image from GitHub Container Registry:

docker pull ghcr.io/giginet/xcodeproj-mcp-server

2. Run the MCP server in Docker with your workspace mounted (example):

docker run --rm -i -v "$PWD:/workspace" ghcr.io/giginet/xcodeproj-mcp-server /workspace

3. If you integrate with Claude Desktop/Claude Code, configure a Claude tool entry that points to the container execution path as described in the configuration examples. For Claude Code, use:

claude mcp add xcodeproj -- docker run --pull=always --rm -i -v $PWD:/workspace ghcr.io/giginet/xcodeproj-mcp-server:latest /workspace

4. For Claude Desktop, add the MCP server configuration to your Claude Desktop configuration file (macOS path provided in README). The entry should resemble the following:

{
  "mcpServers": {
    "xcodeproj": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-v",
        "${workspaceFolder}:/workspace",
        "ghcr.io/giginet/xcodeproj-mcp-server",
        "/workspace"
      ]
    }
  }
}

Prerequisites summary: Docker installed, macOS environment if you are manipulating Xcode projects locally, and access to your workspace files via mounting into the container.

Tips and common considerations:

• The server expects to operate within a base workspace mounted as /workspace inside the container. Ensure your project paths are accessible and passable to the MCP tools.
• If you run in a restricted environment, consider enabling tool loading or dynamic MCP tool loading in Claude to optimize context usage (ENABLE_TOOL_SEARCH).
• When running in Docker, be mindful of file permissions and macOS-specific path conventions to avoid read/write errors.
• The MCP server supports path security by restricting file operations to a base directory. If you provide a base path, all paths will be resolved relative to that base and absolute paths outside the base will be rejected.
• This server exposes a rich set of tools for project management, file operations, and build configuration. Review the Available Tools section in the README to see supported parameters for each command.