Skip to main content
Glama

XcodeMCP

by lapfelix
345
22
  • Apple

XcodeMCP

MCP server for Xcode build automation and log parsing.

What it does

  • Opens Xcode projects and triggers builds in Xcode, not using xcodebuild. 1
  • Parses build logs to extract errors and warnings using XCLogParser
  • Provides MCP tools for AI assistants to interact with Xcode

Requirements

  • macOS with Xcode installed
  • Node.js 18+
  • XCLogParser: brew install xclogparser

Usage

Quick Install

Install from npm

Run directly with npx:

brew install xclogparser npx xcodemcp@latest

Or install globally:

brew install xclogparser npm install -g xcodemcp

MCP Configuration

Add to your MCP configuration:

{ "mcpServers": { "xcodemcp": { "command": "npx", "args": ["xcodemcp@latest"], "env": {} } } }

Claude Code CLI Setup

To add XcodeMCP to Claude Code using the command line:

claude mcp add-json XcodeMCP '{ "command": "npx", "args": ["xcodemcp@latest"], "env": {} }'

Or clone locally:

git clone https://github.com/lapfelix/XcodeMCP.git cd XcodeMCP npm install node index.js

Available Tools

  • xcode_open_project - Open Xcode projects and workspaces
  • xcode_build - Build and get errors/warnings
  • xcode_build_scheme - Build with specific scheme and destination
  • xcode_clean - Clean build artifacts
  • xcode_test - Run unit and UI tests
  • xcode_run - Run the active scheme
  • xcode_debug - Start debugging session
  • xcode_stop - Stop current build/run/test operation
  • xcode_get_schemes - List all available schemes
  • xcode_get_run_destinations - List simulators and devices
  • xcode_set_active_scheme - Switch between schemes
  • xcode_get_workspace_info - Get workspace details and status
  • xcode_get_projects - List projects in workspace
  • xcode_open_file - Open specific files in Xcode

Example

echo '{"jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": {"name": "xcode_build", "arguments": {}}}' | node index.js

Output:

❌ BUILD FAILED (1 errors) ERRORS: • /path/file.swift: 'SomeType' file not found
  1. For an alternative that uses xcodebuild, see XcodeBuildMCP

-
security - not tested
F
license - not found
-
quality - not tested

MCP server for Xcode build automation and log parsing that opens Xcode projects, triggers builds directly in Xcode, and parses build logs to extract errors and warnings.

  1. What it does
    1. Requirements
      1. Usage
        1. Quick Install
        2. Install from npm
        3. MCP Configuration
        4. Claude Code CLI Setup
      2. Available Tools
        1. Example

          Related MCP Servers

          • A
            security
            A
            license
            A
            quality
            MCP server for collecting code from files and directories into a single markdown document.
            Last updated -
            2
            4
            Python
            MIT License
          • A
            security
            A
            license
            A
            quality
            An MCP server that provides access to project files and their contents, allowing users to retrieve file data from specified project directories with error handling and configuration options.
            Last updated -
            1
            4
            TypeScript
            MIT License
          • -
            security
            F
            license
            -
            quality
            This is an MCP server that facilitates building tools for interacting with various APIs and workflows, supporting Python-based development with potential for customizable prompts and user configurations.
            Last updated -
            Python
          • -
            security
            A
            license
            -
            quality
            An MCP server that assists with the orchestration of new software projects by applying standardized templates and best practices in design patterns and software architecture.
            Last updated -
            3
            Python
            MIT License
            • Apple

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/lapfelix/XcodeMCP'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server