Xcode MCP उपयोग दिशानिर्देश AI एजेंटों के लिए

name: xcode-mcp-for-pi-agent description: mcporter CLI के माध्यम से कुशल Xcode MCP टूल उपयोग के लिए दिशानिर्देश। यह स्किल यह समझने के लिए उपयोग की जानी चाहिए कि Xcode MCP टूल्स का उपयोग कब करें बनाम मानक टूल्स का। Xcode MCP बहुत सारे टोकन खपत करता है - केवल बिल्ड, टेस्ट, सिम्युलेटर, प्रीव्यू, और SourceKit डायग्नोस्टिक्स के लिए उपयोग करें। फ़ाइल रीड/राइट/grep ऑपरेशन के लिए कभी उपयोग न करें। Xcode प्रोजेक्ट्स, iOS/macOS बिल्ड्स, SwiftUI प्रीव्यू, या Apple प्लेटफ़ॉर्म डेवलपमेंट के साथ काम करते समय इस स्किल का उपयोग करें। # Xcode MCP उपयोग दिशानिर्देश Xcode MCP टूल्स `mcporter` CLI के माध्यम से एक्सेस किए जाते हैं, जो MCP सर्वर को मानक कमांड-लाइन टूल्स से जोड़ता है। यह स्किल परिभाषित करती है कि Xcode MCP का उपयोग कब करें और मानक टूल्स को कब प्राथमिकता दें। ## सेटअप Xcode MCP को `~/.mcporter/mcporter.json` में कॉन्फ़िगर किया जाना चाहिए: ```json { "mcpServers": { "xcode": { "command": "xcrun", "args": ["mcpbridge"], "env": {} } } } ``` कनेक्शन सत्यापित करें: ```bash mcporter list xcode ``` --- ## टूल्स को कॉल करना सभी Xcode MCP टूल्स mcporter के माध्यम से कॉल किए जाते हैं: ```bash # उपलब्ध टूल्स की सूची mcporter list xcode # key:value आर्ग्स के साथ टूल कॉल करें mcporter call xcode.<tool_name> param1:value1 param2:value2 # फ़ंक्शन-कॉल सिंटैक्स के साथ कॉल करें mcporter call 'xcode.<tool_name>(param1: "value1", param2: "value2")' ``` --- ## संपूर्ण Xcode MCP टूल्स संदर्भ ### विंडो और प्रोजेक्ट प्रबंधन | टूल | mcporter कॉल | टोकन लागत | |------|---------------|------------| | खुली Xcode विंडोज़ की सूची (tabIdentifier प्राप्त करें) | `mcporter call xcode.XcodeListWindows` | कम | ### बिल्ड ऑपरेशन | टूल | mcporter कॉल | टोकन लागत | |------|---------------|------------| | Xcode प्रोजेक्ट बिल्ड करें | `mcporter call xcode.BuildProject` | मध्यम | | त्रुटियों/चेतावनियों के साथ बिल्ड लॉग प्राप्त करें | `mcporter call xcode.GetBuildLog` | मध्यम | | Issue Navigator में समस्याओं की सूची | `mcporter call xcode.XcodeListNavigatorIssues` | कम | ### टेस्टिंग | टूल | mcporter कॉल | टोकन लागत | |------|---------------|------------| | टेस्ट प्लान से उपलब्ध टेस्ट प्राप्त करें | `mcporter call xcode.GetTestList` | कम | | सभी टेस्ट चलाएं | `mcporter call xcode.RunAllTests` | मध्यम | | विशिष्ट टेस्ट चलाएं (पसंदीदा) | `mcporter call xcode.RunSomeTests` | मध्यम | ### प्रीव्यू और निष्पादन | टूल | mcporter कॉल | टोकन लागत | |------|---------------|------------| | SwiftUI प्रीव्यू स्नैपशॉट रेंडर करें | `mcporter call xcode.RenderPreview` | मध्यम | | फ़ाइल संदर्भ में कोड स्निपेट निष्पादित करें | `mcporter call xcode.ExecuteSnippet` | मध्यम | ### डायग्नोस्टिक्स | टूल | mcporter कॉल | टोकन लागत | |------|---------------|------------| | विशिष्ट फ़ाइल के लिए कंपाइलर डायग्नोस्टिक्स प्राप्त करें | `mcporter call xcode.XcodeRefreshCodeIssuesInFile` | कम | | SourceKit डायग्नोस्टिक्स प्राप्त करें (सभी खुली फ़ाइलें) | `mcporter call xcode.getDiagnostics` | कम | ### दस्तावेज़ीकरण | टूल | mcporter कॉल | टोकन लागत | |------|---------------|------------| | Apple डेवलपर दस्तावेज़ीकरण खोजें | `mcporter call xcode.DocumentationSearch` | कम | ### फ़ाइल ऑपरेशन (उच्च टोकन - कभी उपयोग न करें) | MCP टूल | इसके बजाय उपयोग करें | क्यों | |----------|-------------|-----| | `xcode.XcodeRead` | `Read` टूल / `cat` | उच्च टोकन खपत | | `xcode.XcodeWrite` | `Write` टूल | उच्च टोकन खपत | | `xcode.XcodeUpdate` | `Edit` टूल | उच्च टोकन खपत | | `xcode.XcodeGrep` | `rg` / `grep` | उच्च टोकन खपत | | `xcode.XcodeGlob` | `find` / `glob` | उच्च टोकन खपत | | `xcode.XcodeLS` | `ls` कमांड | उच्च टोकन खपत | | `xcode.XcodeRM` | `rm` कमांड | उच्च टोकन खपत | | `xcode.XcodeMakeDir` | `mkdir` कमांड | उच्च टोकन खपत | | `xcode.XcodeMV` | `mv` कमांड | उच्च टोकन खपत | --- ## अनुशंसित वर्कफ़्लो ### 1. कोड परिवर्तन और बिल्ड फ़्लो ``` 1. कोड खोजें -> rg "pattern" --type swift 2. फ़ाइल पढ़ें -> Read टूल / cat 3. फ़ाइल संपादित करें -> Edit टूल 4. सिंटैक्स जांच -> mcporter call xcode.getDiagnostics 5. बिल्ड -> mcporter call xcode.BuildProject 6. त्रुटियां जांचें -> mcporter call xcode.GetBuildLog (यदि बिल्ड विफल हो) ``` ### 2. टेस्ट लेखन और चलाने का फ़्लो ``` 1. टेस्ट फ़ाइल पढ़ें -> Read टूल / cat 2. टेस्ट लिखें/संपादित करें -> Edit टूल 3. टेस्ट सूची प्राप्त करें -> mcporter call xcode.GetTestList 4. टेस्ट चलाएं -> mcporter call xcode.RunSomeTests (विशिष्ट टेस्ट) 5. परिणाम जांचें -> टेस्ट आउटपुट की समीक्षा करें ``` ### 3. SwiftUI प्रीव्यू फ़्लो ``` 1. व्यू संपादित करें -> Edit टूल 2. प्रीव्यू रेंडर करें -> mcporter call xcode.RenderPreview 3. पुनरावृत्ति करें -> आवश्यकतानुसार दोहराएं ``` ### 4. डीबग फ़्लो ``` 1. डायग्नोस्टिक्स जांचें -> mcporter call xcode.getDiagnostics 2. प्रोजेक्ट बिल्ड करें -> mcporter call xcode.BuildProject 3. बिल्ड लॉग प्राप्त करें -> mcporter call xcode.GetBuildLog severity:error 4. समस्याएं ठीक करें -> Edit टूल 5. पुनः बिल्ड करें -> mcporter call xcode.BuildProject ``` ### 5. दस्तावेज़ीकरण खोज ``` 1. दस्तावेज़ खोजें -> mcporter call xcode.DocumentationSearch query:"SwiftUI NavigationStack" 2. परिणामों की समीक्षा करें -> कार्यान्वयन में जानकारी का उपयोग करें ``` --- ## फ़ॉलबैक कमांड (जब MCP या mcporter अनुपलब्ध हो) यदि Xcode MCP डिस्कनेक्ट है, mcporter इंस्टॉल नहीं है, या कनेक्शन विफल हो जाता है, तो इन xcodebuild कमांड्स का सीधे उपयोग करें: ### बिल्ड कमांड्स ```bash # डीबग बिल्ड (सिम्युलेटर) - <SchemeName> को अपने प्रोजेक्ट के स्कीम से बदलें xcodebuild -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # रिलीज़ बिल्ड (डिवाइस) xcodebuild -scheme <SchemeName> -configuration Release -sdk iphoneos build # वर्कस्पेस के साथ बिल्ड (CocoaPods प्रोजेक्ट्स के लिए) xcodebuild -workspace <ProjectName>.xcworkspace -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # प्रोजेक्ट फ़ाइल के साथ बिल्ड xcodebuild -project <ProjectName>.xcodeproj -scheme <SchemeName> -configuration Debug -sdk iphonesimulator build # उपलब्ध स्कीम्स की सूची xcodebuild -list ``` ### टेस्ट कमांड्स ```bash # सभी टेस्ट चलाएं xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -configuration Debug # विशिष्ट टेस्ट क्लास चलाएं xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName> # विशिष्ट टेस्ट मेथड चलाएं xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -destination "platform=iOS Simulator,name=iPhone 16" \ -only-testing:<TestTarget>/<TestClassName>/<testMethodName> # कोड कवरेज के साथ चलाएं xcodebuild test -scheme <SchemeName> -sdk iphonesimulator \ -configuration Debug -enableCodeCoverage YES # उपलब्ध सिम्युलेटर की सूची xcrun simctl list devices available ``` ### क्लीन बिल्ड ```bash xcodebuild clean -scheme <SchemeName> ``` --- ## त्वरित संदर्भ ### mcporter + Xcode MCP का उपयोग करें: - `xcode.BuildProject` - बिल्डिंग - `xcode.GetBuildLog` - बिल्ड त्रुटियां - `xcode.RunSomeTests` - विशिष्ट टेस्ट चलाना - `xcode.GetTestList` - टेस्ट सूचीबद्ध करना - `xcode.RenderPreview` - SwiftUI प्रीव्यू - `xcode.ExecuteSnippet` - कोड निष्पादन - `xcode.DocumentationSearch` - Apple दस्तावेज़ - `xcode.XcodeListWindows` - tabIdentifier प्राप्त करें - `xcode.getDiagnostics` - SourceKit त्रुटियां ### Xcode MCP का कभी उपयोग न करें: - `xcode.XcodeRead` -> `Read` टूल / `cat` का उपयोग करें - `xcode.XcodeWrite` -> `Write` टूल का उपयोग करें - `xcode.XcodeUpdate` -> `Edit` टूल का उपयोग करें - `xcode.XcodeGrep` -> `rg` या `grep` का उपयोग करें - `xcode.XcodeGlob` -> `find` / `glob` का उपयोग करें - `xcode.XcodeLS` -> `ls` कमांड का उपयोग करें - फ़ाइल ऑपरेशन -> मानक टूल्स का उपयोग करें --- ## टोकन दक्षता सारांश | ऑपरेशन | सर्वोत्तम विकल्प | टोकन प्रभाव | |-----------|-------------|--------------| | त्वरित सिंटैक्स जांच | `mcporter call xcode.getDiagnostics` | कम | | पूर्ण बिल्ड | `mcporter call xcode.BuildProject` | मध्यम | | विशिष्ट टेस्ट चलाएं | `mcporter call xcode.RunSomeTests` | मध्यम | | सभी टेस्ट चलाएं | `mcporter call xcode.RunAllTests` | उच्च | | फ़ाइल पढ़ें | `Read` टूल / `cat` | कम | | फ़ाइल संपादित करें | `Edit` टूल | कम | | कोड खोजें | `rg` / `grep` | कम | | फ़ाइलें सूचीबद्ध करें | `ls` / `find` | कम |