XcodeBuildMCP

एक मॉडल कॉन्टेक्स्ट प्रोटोकॉल (MCP) सर्वर और CLI जो iOS और macOS प्रोजेक्ट्स पर काम करते समय एजेंट उपयोग के लिए उपकरण प्रदान करता है।

स्थापना

MobileBuildMCP एक ही पैकेज के रूप में दो मोड के साथ आता है: टर्मिनल में सीधे उपयोग के लिए एक CLI और AI कोडिंग एजेंटों के लिए एक MCP सर्वर। कोई भी स्थापना विधि आपको दोनों देती है।

विकल्प A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp

विकल्प B — npm (Node.js 18+)

npm install -g mobilebuildmcp@latest

किसी भी स्थापना को सत्यापित करें:

mobilebuildmcp --help

अपने MCP क्लाइंट को कनेक्ट करें

Cursor, Claude Code, Codex के लिए ड्रॉप-इन कॉन्फ़िग स्निपेट आधिकारिक दस्तावेज़ पृष्ठ MCP Clients पर पाए जा सकते हैं। अधिकांश क्लाइंट वैश्विक स्थापना के बिना npx -y mobilebuildmcp@latest mcp के माध्यम से MCP सर्वर को मांग पर भी चला सकते हैं।

आवश्यकताएँ

• macOS 14.5 या बाद का संस्करण
• Xcode 16.x या बाद का संस्करण
• Node.js 18.x या बाद का संस्करण (Homebrew स्थापना के लिए आवश्यक नहीं)

कौशल

MobileBuildMCP में अब दो वैकल्पिक एजेंट कौशल शामिल हैं:

• MCP कौशल: एजेंट को MCP सर्वर के उपकरणों का उपयोग करने के तरीके के निर्देशों के साथ तैयार करता है (MCP सर्वर का उपयोग करते समय वैकल्पिक)।

• CLI कौशल: एजेंट को CLI को नेविगेट करने के तरीके के निर्देशों के साथ तैयार करता है (CLI का उपयोग करते समय अनुशंसित)।

वैश्विक बाइनरी के साथ स्थापित करने के लिए:

mobilebuildmcp init

या वैश्विक स्थापना के बिना सीधे npx के माध्यम से स्थापित करें:

npx -y mobilebuildmcp@latest init

कौशल स्थापित करने के बारे में अधिक जानकारी के लिए, Agent Skills देखें।

नोट्स

• MobileBuildMCP Swift Macros का उपयोग करने वाले प्रोजेक्ट्स बनाते समय त्रुटियों से बचने के लिए xcodebuild से मैक्रो सत्यापन छोड़ने का अनुरोध करता है।
• डिवाइस उपकरणों के लिए Xcode में कोड साइनिंग कॉन्फ़िगर होना आवश्यक है। Device Code Signing देखें।

गोपनीयता

MobileBuildMCP केवल आंतरिक रनटाइम त्रुटि टेलीमेट्री के लिए Sentry का उपयोग करता है। विवरण और ऑप्ट-आउट निर्देशों के लिए, Privacy & Telemetry देखें।

CLI

MobileBuildMCP एक एकीकृत कमांड-लाइन इंटरफ़ेस प्रदान करता है। mcp उपकमांड MCP सर्वर शुरू करता है, जबकि अन्य सभी कमांड उपकरणों तक सीधे टर्मिनल पहुंच प्रदान करते हैं:

# Install globally
npm install -g mobilebuildmcp@latest

# Start the MCP server (for MCP clients)
mobilebuildmcp mcp

# List available tools
mobilebuildmcp tools

# Build for simulator
mobilebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj

# Prepare portable test products without running tests
mobilebuildmcp simulator build --scheme MyApp --project-path ./MyApp.xcodeproj --simulator-name "iPhone 17" --build-for-testing --test-products-path ./MyApp.xctestproducts

# Run previously prepared test products
mobilebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"

अपडेट की जाँच करें और स्थान पर अपग्रेड करें:

mobilebuildmcp upgrade --check
mobilebuildmcp upgrade --yes

CLI स्टेटफुल संचालन (लॉग कैप्चर, डिबगिंग, आदि) के लिए प्रति-वर्कस्पेस डेमॉन का उपयोग करता है जो आवश्यकता पड़ने पर स्वतः शुरू होता है। पूर्ण दस्तावेज़ीकरण के लिए CLI guide देखें।

दस्तावेज़ीकरण

• स्थापना: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/installation.mdx
• सेटअप: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/setup.mdx
• MCP क्लाइंट: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/clients.mdx
• CLI उपयोग: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/cli.mdx
• कॉन्फ़िगरेशन और विकल्प: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/configuration.mdx
• उपकरण संदर्भ: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/tools.mdx
• समस्या निवारण: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/troubleshooting.mdx
• गोपनीयता: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/privacy.mdx
• कौशल: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/skills.mdx
• योगदान: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/contributing.mdx

लाइसेंस

यह प्रोजेक्ट MIT लाइसेंस के अंतर्गत लाइसेंस प्राप्त है - विवरण के लिए LICENSE फ़ाइल देखें। तृतीय-पक्ष लाइसेंसिंग सूचनाओं के लिए THIRD_PARTY_LICENSES फ़ाइल देखें। npm पैकेज एट्रिब्यूशन के लिए THIRD_PARTY_PACKAGE_LICENSES फ़ाइल देखें।