MCPgee
MCPgee
MCPgeeMCPgee

Xcodeproj

v1.0.0•Developer Tools•stable

A Model Context Protocol Server to manipulate *.xcodeproj

xcodeprojmcpai-integration
Share:
129
Stars
0
Downloads
0
Weekly
0/5
View on GitHub

What is Xcodeproj?

Xcodeproj is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to model context protocol server to manipulate *.xcodeproj

A Model Context Protocol Server to manipulate *.xcodeproj

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • A Model Context Protocol Server to manipulate *.xcodeproj

Use Cases

Manipulate Xcode project files programmatically.
Automate iOS development workflows through AI assistance.
giginet

Maintainer

LicenseMIT
Languageswift
Versionv1.0.0
UpdatedMay 3, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux
View SourceBrowse All Servers

Installation

Manual Installation

npx xcodeproj

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Xcodeproj

The Xcodeproj MCP Server allows AI assistants to read and manipulate Xcode project files (*.xcodeproj) programmatically through the Model Context Protocol. It exposes tools for managing targets, files, groups, build settings, Swift packages, and app extensions—enabling AI-driven automation of iOS, macOS, and other Apple platform project configurations without opening Xcode. The server runs as a Docker container and mounts your workspace directory so it can safely access your project files.

Prerequisites

  • Docker installed and running on macOS or Linux
  • An existing Xcode project (*.xcodeproj) in your workspace
  • An MCP-compatible client: Claude Desktop or Claude Code
  • For Claude Code, the ENABLE_TOOL_SEARCH environment variable must be set to enable dynamic tool loading
1

Pull the Docker image

Pull the xcodeproj-mcp-server Docker image from the GitHub Container Registry.

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

Add to Claude Code (quickest method)

For Claude Code users, add the server with a single command. This mounts your current directory as /workspace inside the container.

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

Enable dynamic tool search in Claude Code

For Claude Code, add the ENABLE_TOOL_SEARCH setting to .claude/settings.json to allow the server's tools to be discovered dynamically.

{
  "env": {
    "ENABLE_TOOL_SEARCH": "1"
  }
}
4

Configure Claude Desktop

For Claude Desktop, add the xcodeproj server to your claude_desktop_config.json. Replace ${workspaceFolder} with the absolute path to your project directory.

5

Open a project and start using tools

With the server connected, ask Claude to inspect or modify your Xcode project. The server exposes over 25 tools covering all major project management operations.

Xcodeproj Examples

Client configuration

Add the xcodeproj MCP server to Claude Desktop's configuration. The container mounts your project directory as /workspace.

{
  "mcpServers": {
    "xcodeproj": {
      "command": "docker",
      "args": [
        "run",
        "--pull=always",
        "--rm",
        "-i",
        "-v",
        "/path/to/your/project:/workspace",
        "ghcr.io/giginet/xcodeproj-mcp-server:latest",
        "/workspace"
      ]
    }
  }
}

Prompts to try

Use these prompts with Claude after connecting the xcodeproj MCP server to automate Xcode project tasks.

- "List all targets in my Xcode project"
- "Add a new file 'NetworkManager.swift' to the main app target"
- "Add the Alamofire Swift package with URL https://github.com/Alamofire/Alamofire.git"
- "Create a new notification service extension target"
- "Show me all build settings for the Release configuration"
- "Add the 'NSCameraUsageDescription' build setting to the main target"

Troubleshooting Xcodeproj

Docker container cannot find or open the .xcodeproj file

Ensure the volume mount path is correct. The container expects the workspace directory (containing the .xcodeproj) to be mounted at /workspace. Use an absolute path in the -v flag. Check with 'docker run --rm -v $PWD:/workspace ghcr.io/giginet/xcodeproj-mcp-server ls /workspace'.

Tools are not discovered or available in Claude Code

Set ENABLE_TOOL_SEARCH=1 in .claude/settings.json (not as a system environment variable). This env var is specific to Claude Code and enables dynamic tool discovery from the MCP server at runtime.

Docker image pull fails or is outdated

The command includes --pull=always which forces a fresh pull each time. If Docker is rate-limited on ghcr.io, authenticate with 'docker login ghcr.io' using your GitHub credentials. Run 'docker pull ghcr.io/giginet/xcodeproj-mcp-server:latest' manually to pre-cache the image.

Frequently Asked Questions about Xcodeproj

What is Xcodeproj?

Xcodeproj is a Model Context Protocol (MCP) server that model context protocol server to manipulate *.xcodeproj It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Xcodeproj?

Follow the installation instructions on the Xcodeproj GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Xcodeproj?

Xcodeproj works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Xcodeproj free to use?

Yes, Xcodeproj is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Learn More About MCP Servers

Getting Started with MCP

Set up your first MCP server in minutes

MCP Setup Guide

Configure MCP in Claude, Cursor & VS Code

All MCP Tutorials

18+ hands-on guides for developers

MCP FAQ

40+ answers about Model Context Protocol

Xcodeproj Alternatives — Similar Developer Tools Servers

Looking for alternatives to Xcodeproj? Here are other popular developer tools servers you can use with Claude, Cursor, and VS Code.

Ecc

★ 188.2k

The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

Javaguide

★ 155.8k

Java 面试 & 后端通用面试指南，覆盖计算机基础、数据库、分布式、高并发、系统设计与 AI 应用开发

Gemini CLI

★ 104.5k

A secure MCP server that wraps the Google Gemini CLI, allowing clients to query Gemini models using local OAuth sessions without requiring an API key. It provides tools for model interaction and diagnostics with built-in protection against command in

Awesome MCP Servers

★ 87.3k

⭐ Curated list of Model Context Protocol (MCP) servers - tools that extend Claude Desktop, Cursor, Windsurf, and other MCP clients with custom capabilities.

MCP Servers

★ 86.0k

Model Context Protocol Servers

CC Switch

★ 77.5k

A cross-platform desktop All-in-One assistant for Claude Code, Codex, OpenCode, OpenClaw, Gemini CLI & Hermes Agent. Only official website: ccswitch.io

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Developer ToolsBrowse All Servers

Quick Config Preview

{ "mcpServers": { "xcodeproj": { "command": "npx", "args": ["-y", "xcodeproj"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Xcodeproj?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides
Explore All ServersRead Our Guides