xcodeproj-mcp-server CLAUDE.md

xcodeproj-mcp-server

A Model Context Protocol (MCP) server for manipulating Xcode project files (.xcodeproj) using Swift.

Overview

This project provides an MCP server that enables interaction with Xcode projects through a standardized protocol. It leverages the tuist/xcodeproj library for project manipulation and the modelcontextprotocol/swift-sdk for MCP functionality.

Architecture

• Language: Swift
• Platform: macOS 13+
• Dependencies:
  • ModelContextProtocol (MCP Swift SDK)
  • XcodeProj (Xcode project manipulation)

Package Structure

The project is organized into multiple targets for better modularity and testability:

xcodeproj-mcp-server/
├── Package.swift
├── Sources/
│   ├── XcodeProjectMCP/           # Library target
│   │   ├── XcodeProjectMCPServer.swift
│   │   ├── CreateXcodeprojTool.swift
│   │   └── [other tool implementations]
│   └── xcodeproj-mcp-server/      # Executable target
│       └── main.swift
├── Tests/
│   └── XcodeProjectMCPTests/      # Test target
│       └── CreateXcodeprojToolTests.swift
└── CLAUDE.md

Targets

• XcodeProjectMCP (Library): Core functionality and MCP tools

  • Contains all tool implementations
  • Provides the main server class
  • Can be imported by other Swift packages

• xcodeproj-mcp-server (Executable): Command-line interface

  • Minimal main.swift that starts the server
  • Depends on XcodeProjectMCP library

• XcodeProjectMCPTests (Test): Unit tests

  • Tests for tool implementations
  • Integration tests for MCP functionality
  • All tests are written using swift-testing framework

Available Tools

Core Operations

• create_xcodeproj - Create a new Xcode project with basic configuration
• list_targets - List all targets in an Xcode project
• list_build_configurations - List all build configurations
• list_files - List all files in a specific target
• get_build_settings - Get build settings for a specific target