majiayu000 /mcp-setup - MCP Session Configuration
Purpose
Configures MCP (Model Context Protocol) session defaults for iOS simulator and Xcode build operations. This skill ensures the correct project, scheme, and simulator are set before any build or test operations.
Critical Rule: MCP defaults MUST be set before building. Building without proper defaults will fail.
Usage
/mcp-setup ios # Configure for main iOS app (default)
/mcp-setup usm # Configure for Server Manager app
/mcp-setup show # Show current session defaults
/mcp-setup clear # Clear session defaults
Configurations
iOS App (default)
Project: $PROJECT_ROOT/UnaMentis.xcodeproj
Scheme: UnaMentis
Simulator: iPhone 16 Pro
Server Manager (USM)
Workspace: $PROJECT_ROOT/server/server-manager/USMXcode/USM.xcworkspace
Scheme: USM
Simulator: iPhone 16 Pro
Where $PROJECT_ROOT is the absolute path to the unamentis repository on this machine (the current working directory).
Workflow
1. Set Session Defaults
For iOS app:
mcp__XcodeBuildMCP__session-set-defaults({
projectPath: "$PROJECT_ROOT/UnaMentis.xcodeproj",
scheme: "UnaMentis",
simulatorName: "iPhone 16 Pro"
})
For USM:
mcp__XcodeBuildMCP__session-set-defaults({
workspacePath: "$PROJECT_ROOT/server/server-manager/USMXcode/USM.xcworkspace",
scheme: "USM",
simulatorName: "iPhone 16 Pro"
})
Note: Replace $PROJECT_ROOT with the actual absolute path to the unamentis directory (use pwd in the project root to get this).
2. Verify Configuration
mcp__XcodeBuildMCP__session-show-defaults()
3. Confirm Simulator Available
mcp__XcodeBuildMCP__list_sims()
Ensure the target simulator exists and is available.
Success Criteria
- Session defaults set successfully
- Scheme is valid for the project
- Simulator exists and is available
Examples
Configure for iOS development:
User: /mcp-setup ios
Claude: Configuring MCP for iOS app development...
Setting defaults:
- Project: UnaMentis.xcodeproj
- Scheme: UnaMentis
- Simulator: iPhone 16 Pro
Configuration complete. You can now use:
- /ios-build or build commands
- MCP simulator tools
Configure for USM development:
User: /mcp-setup usm
Claude: Configuring MCP for Server Manager development...
Setting defaults:
- Workspace: USM.xcworkspace
- Scheme: USM
- Simulator: iPhone 16 Pro
Configuration complete. Ready to build USM.
Show current configuration:
User: /mcp-setup show
Claude: Current MCP session defaults:
Project: $PROJECT_ROOT/UnaMentis.xcodeproj
Scheme: UnaMentis
Simulator: iPhone 16 Pro (ID: 12345678-1234-1234-1234-123456789ABC)
Configuration: Debug
Clear configuration:
User: /mcp-setup clear
Claude: Clearing MCP session defaults...
All session defaults cleared. Run /mcp-setup ios or /mcp-setup usm to reconfigure.
Available Simulators
Common simulators (verify with list_sims):
- iPhone 16 Pro (preferred for CI parity)
- iPhone 17 Pro
- iPhone 15 Pro
- iPad Pro 13-inch
Note: iPhone 16 Pro is the default to match CI. The test runner includes automatic fallback to other available simulators if the preferred one is not found.
Integration
This skill should be run:
- At the start of a development session
- When switching between iOS app and USM development
- Before any build or test operations
- When the simulator needs to change