xc-mcp
🥈SilverXC-MCP is a TypeScript-based convenience wrapper for Xcode CLI tools and iOS Simulator. It reduces context usage with progressive disclosure of tool responses. Use --mini for build-only with minimal context footprint. Ideal for iOS developers and operations teams automating build and test workflows.
9240Updated 3mo ago
Intermediate30min to implementautomation
Saves ~45 min per use
Quick InstallView Source
git clone https://github.com/conorluddy/xc-mcp.gitWorks with:
Claude
Overview
About This Skill
XC-MCP is a production-grade MCP server designed to make Xcode and iOS Simulator tooling accessible to AI agents while solving the token overflow problem that breaks traditional MCP clients. It uses progressive disclosure patterns—returning concise summaries with cache IDs rather than massive raw output—to reduce context overhead by up to 96%. The server includes 29 deferred-loading tools covering xcodebuild operations, simulator management, app installation, and accessibility-first UI automation. V3.0.0 adds platform-native defer_loading support so Claude discovers tools on-demand with zero baseline overhead. It's ideal for iOS developers, CI/CD pipelines, and operations teams who need reliable automated build, test, and deployment workflows without exceeding MCP protocol limits.
How to Use
Install globally with `npm install -g xc-mcp` or use `npx xc-mcp`. Add to Claude Desktop config at `~/Library/Application Support/Claude/claude_desktop_config.json` with `"command": "npx"` and `"args": ["-y", "xc-mcp"]`. Use `--mini` flag for ~97% token reduction on minimal tool descriptions, or `--build-only` for build-focused workflows without UI automation.
Use Cases
Automate iOS app builds and tests via Claude AI agents
Query simulator device state without token overflow (96% reduction)
Install, launch, and control apps on simulated devices
Retrieve and manage build logs with on-demand detail access
Tags
Setup & Installation
Quick Install
No install command available. Check the GitHub repository for manual installation instructions.
Alternative Install (Git Clone)
git clone https://github.com/conorluddy/xc-mcpRequirements
- Claude Code or compatible AI agent
- Works with: Claude
Quick Start Guide
1
Install the Skill
Copy the install command above and run it in your terminal.
2
Open Your AI Agent
Launch Claude Code, Cursor, or your preferred AI coding agent.
3
Try It Out
Use the prompt template or examples below to test the skill.
4
Customize
Adapt the skill to your specific use case and workflow.
Usage Examples
Prompt Template
I'm using XC-MCP to automate my iOS build and test workflows. Here's my setup: [COMPANY] is developing an app for [INDUSTRY]. I need to build and test this app using [DATA] as my test data. Can you guide me through the process using XC-MCP?
Example Output
# XC-MCP Build and Test Workflow Guide ## Step 1: Initialize XC-MCP ```bash xc-mcp init --project-path /path/to/your/project --scheme YourAppScheme ``` ## Step 2: Configure Build Settings ```bash xc-mcp configure --configuration Release --destination 'platform=iOS Simulator,name=iPhone 13' ``` ## Step 3: Build the Project ```bash xc-mcp build --mini ``` ## Step 4: Run Tests ```bash xc-mcp test --data /path/to/test/data --reporter junit ``` ## Step 5: Clean Up ```bash xc-mcp clean ``` ## Notes - Ensure you have the correct Xcode version installed. - Replace placeholders with your actual project details. - Use `--mini` flag for minimal context footprint during builds.
Apply to these tools
Browse all toolsSage
Accounting software with automated invoicing and reporting
Swift Concurrency Agent Skill
Swift 6 concurrency patterns for AI agents
Microsoft Teams
Get more done every day with Microsoft Teams – powered by AI
GPT for work
Automate your spreadsheet tasks with AI power
Respell
Agentic AI Workflow platform
Notion
Connected workspace for docs, wikis, and projects
Compatible MCP servers
Browse all MCP servers
Find the right skills for your stack
Take a free 3-minute scan and get personalized AI skill recommendations.
Take free scan