xcodeproj-mcp-server

@giginet

About xcodeproj-mcp-server

A Model Context Protocol Server to manipulate *.xcodeproj

Config

Add this server to your MCP-compatible client using the configuration below.

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

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

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., `

Frequently asked questions

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., `

Comments

Basic information

More Other MCP servers

XcodeBuildMCP

cameroncooke

A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.

6.0K

Inbox Zero AI

elie222

The world's best AI personal assistant for email. Open source app to help you reach inbox zero fast.

11.6K

MCP Registry

modelcontextprotocol

A community driven registry service for Model Context Protocol (MCP) servers.

7.0K

Unity MCP ✨

justinpbarnett

Unity MCP acts as a bridge between AI assistants and your Unity Editor. Give your LLM tools to manage assets, control scenes, edit scripts, and automate tasks within Unity.

12.2K

Codelf

unbug

A search tool helps dev to solve the naming things problem.

14.2K