Installation

Quick Install

The fastest way to get started — no global install needed:

npx xcode-pilot-mcp

This downloads and runs the latest version on demand. Most MCP clients use this approach in their configuration.

Global Install

If you prefer a permanent installation:

npm

npm install -g xcode-pilot-mcp

yarn

yarn global add xcode-pilot-mcp

pnpm

pnpm add -g xcode-pilot-mcp

Verify the installation:

xcode-pilot-mcp --help

Install from Source

For development or to run the latest unreleased changes:

1. Clone the repository:

   git clone https://github.com/sitharaj88/xcode-pilot-mcp.git
   cd xcode-pilot-mcp

2. Install dependencies:

   npm install

3. Build the project:

   npm run build

4. Run the server:

   node build/index.js

Tip

During development, use npm run dev for watch mode — it rebuilds automatically when you change source files.

How It Works

Xcode Pilot MCP is a stdio-based MCP server. It communicates with your AI assistant over stdin/stdout using the Model Context Protocol. You don’t interact with it directly — your MCP client (Claude Code, Cursor, etc.) launches it automatically.

┌──────────────┐     MCP (stdio)     ┌──────────────────┐
│  AI Assistant │ ◄────────────────► │  Xcode Pilot MCP │
│  (Claude, etc)│                    │  (this server)    │
└──────────────┘                    └────────┬─────────┘
                                             │
                                    ┌────────▼─────────┐
                                    │  Xcode Toolchain  │
                                    │  xcodebuild       │
                                    │  xcrun simctl      │
                                    │  devicectl         │
                                    │  security          │
                                    └──────────────────┘

Next Step

Configure your editor to use Xcode Pilot MCP: Configuration.