XcodeBuildMCP

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

इंस्टॉलेशन

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

विकल्प A — Homebrew

brew tap getsentry/xcodebuildmcp
brew install xcodebuildmcp

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

npm install -g xcodebuildmcp@latest

किसी भी इंस्टॉल को सत्यापित करें:

xcodebuildmcp --help

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

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

आवश्यकताएँ

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

स्किल्स

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

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

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

वैश्विक बाइनरी के साथ इंस्टॉल करने के लिए:

xcodebuildmcp init

या वैश्विक इंस्टॉल के बिना सीधे npx के माध्यम से इंस्टॉल करें:

npx -y xcodebuildmcp@latest init

स्किल्स इंस्टॉल करने के बारे में अधिक जानकारी के लिए, Agent Skills देखें।

नोट्स

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

गोपनीयता

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

CLI

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

# Install globally
npm install -g xcodebuildmcp@latest

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

# List available tools
xcodebuildmcp tools

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

# Prepare portable test products without running tests
xcodebuildmcp 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
xcodebuildmcp simulator test --test-products-path ./MyApp.xctestproducts --simulator-name "iPhone 17"

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

xcodebuildmcp upgrade --check
xcodebuildmcp upgrade --yes

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

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

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

लाइसेंस

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