XcodeBuildMCP-iOS-Template
A scaffold template for iOS app projects
Links
README
From the repo.
XcodeBuildMCP iOS Template
A modern iOS application template using a workspace + SPM package architecture for clean separation between app shell and feature code. This template is designed to be used with XcodeBuildMCP.
Features
- ✨ Modern Architecture: Workspace + Swift Package Manager structure
- 📦 Clean Separation: Minimal app shell with features in SPM package
- 🏗️ Buildable Folders: Xcode 16 support for automatic file discovery
- 🧪 Test Ready: Preconfigured with Swift Testing and XCUITest
- ⚙️ XCConfig Based: Build settings managed through configuration files
- 🚀 AI-Friendly: Designed for use with AI coding assistants
Quick Start
Using XcodeBuildMCP
The easiest way to use this template is through XcodeBuildMCP:
# Using the XcodeBuildMCP tool
mcp scaffold_ios_project --projectName "YourApp" --outputPath "./YourApp"
Manual Download
You can also download the template directly from the releases page.
Template Structure
template/
├── Config/ # XCConfig build settings
│ ├── Debug.xcconfig
│ ├── Release.xcconfig
│ ├── Shared.xcconfig
│ └── Tests.xcconfig
├── MyProject.xcworkspace/ # Workspace file
├── MyProject.xcodeproj/ # App shell project
├── MyProject/ # App target (minimal)
│ ├── Assets.xcassets/
│ ├── MyProjectApp.swift
│ └── MyProject.xctestplan
├── MyProjectPackage/ # SPM package for features
│ ├── Package.swift
│ ├── Sources/
│ └── Tests/
└── MyProjectUITests/ # UI automation tests
Customization
When using this template, the following placeholders will be replaced:
MyProject→ Your project namecom.example.MyProject→ Your bundle identifierMyProjectFeature→ Your feature module name- Build settings can be customized in the
Config/XCConfig files
Requirements
- Xcode 16.0 or later
- iOS 18.0+ deployment target (configurable)
- Swift 6.0
Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
License
This template is available under the MIT license. See the LICENSE file for more info.
Related Projects
- XcodeBuildMCP - AI-powered Xcode build and development tools
- XcodeBuildMCP macOS Template - macOS app template
Generated with ❤️ for the Swift community
Collected info
- ★ 42 stars
- ⎇ 3 forks
- Language: Shell
- Source updated: 6/13/2025
Config for your environment
Replace {MCP_ENDPOINT_URL} with this MCP’s endpoint URL (from its repo or docs above). No API key — you connect directly.
Tool
OS
Config file: ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "{MCP_ENDPOINT_URL}"
}
}
}Paste into mcpServers in the config file. Restart Cursor after saving.
If this MCP is also published on mcpchannel.ai, you can subscribe from Browse and use the gateway config there instead.