XcodeBuildMCP MCP Server

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

इंस्टॉलेशन

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

विकल्प 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

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

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 फ़ाइल देखें।