xc-mcp
Version:
MCP server that wraps Xcode command-line tools for iOS/macOS development workflows
27 lines • 3 kB
TypeScript
/**
* Intelligent simulator suggestion tool
*
* Suggests the best simulators for your project based on:
* - Project preferences (remembered from previous successful builds)
* - Recently used simulators
* - Device popularity (iPhone 16 > iPhone 15, etc.)
* - Boot performance metrics
*
* Scoring Algorithm (100 point scale):
* - Project preference: 40 points
* - Recent usage: 40 points
* - iOS version: 30 points (newer = higher)
* - Popular model: 20 points (iPhone 16 Pro > iPhone 16, etc.)
* - Boot performance: 10 points (faster = higher)
*
* **Full documentation:** See simctl/suggest.md for detailed parameters and examples
*/
export declare function simctlSuggestTool(args: any): Promise<{
content: {
type: "text";
text: string;
}[];
isError: boolean;
}>;
export declare const SIMCTL_SUGGEST_DOCS = "\n# simctl-suggest\n\nIntelligent simulator suggestion tool.\n\n## Overview\n\nSuggests the best simulators for your project based on project preferences (remembered from previous successful builds), recently used simulators, device popularity (iPhone 16 > iPhone 15), and boot performance metrics. Transparent scoring algorithm shows reasoning for each recommendation.\n\n## Parameters\n\n### Required\nNone - all parameters are optional\n\n### Optional\n- **projectPath** (string): Project directory for project-specific ranking\n- **deviceType** (string): Filter suggestions by device type\n- **maxSuggestions** (number, default: 4): Maximum number of suggestions to return\n- **autoBootTopSuggestion** (boolean, default: false): Automatically boot top suggestion\n\n## Returns\n\nRanked suggestions with scores, reasoning, boot history, performance metrics, summary of scoring criteria, and guidance for next steps. Each suggestion includes simulator name, UDID, state, availability, score breakdown, and boot performance data.\n\n## Examples\n\n### Get project-specific suggestions\n```typescript\nawait simctlSuggestTool({\n projectPath: '/path/to/project'\n});\n```\n\n### Auto-boot top suggestion\n```typescript\nawait simctlSuggestTool({\n projectPath: '/path/to/project',\n autoBootTopSuggestion: true\n});\n```\n\n### Filter by device type\n```typescript\nawait simctlSuggestTool({\n deviceType: 'iPhone',\n maxSuggestions: 3\n});\n```\n\n## Related Tools\n\n- simctl-boot: Boot suggested simulator\n- simctl-list: See all available simulators\n- simctl-health-check: Validate environment health\n\n## Notes\n\n- Scoring algorithm (100 point scale): Project preference (40), Recent usage (40), iOS version (30), Popular model (20), Boot performance (10)\n- Project-aware: Remembers preferred simulator per project\n- Performance metrics: Learns boot times and reliability from usage\n- Popularity ranking: Suggests popular models (iPhone 16 Pro > iPhone 15)\n- Transparent scoring: Shows reasoning for each recommendation\n- Auto-boot option: Optionally boots top suggestion immediately\n";
//# sourceMappingURL=suggest.d.ts.map