
lapfelix/xcodemcp
Developer tools이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기
AppleScript 인터페이스를 감싸는 Xcode용 MCP 서버 및 XCLogParser를 사용하여 명확한 빌드 결과를 반환합니다
개요
: Apple은 이제 공식 Xcode MCP 서버를 제공합니다. XcodeMCP는 프로젝트 관리 및 XCResult 분석과 같은 보완 도구를 제공합니다 (--sidekick-only)에 따라 실행할 수 있습니다. 향후 버전에서 XcodeMCP는 기본적으로 Sidekick-only 모드로 전환합니다. 아래 설정 참조. Model Context Protocol (MCP) 서버는 Xcode를 자동화 (JXA)를 통해 직접 제어합니다. MCP 서버와 독립 CLI 모두 가능 - Xcode가 Xcodebuild CLI를 사용하여 JavaScript를 통해 Xcode를 직접 제어합니다. 프로젝트, 빌드, 실행, 테스트 및 Xcode 내의 디버깅을 엽니다. Parses는 XCLogParser를 사용하여 정확한 오류 위치를 사용하여 로그를 빌드합니다. 포괄적 인 환경 검증 및 건강 검사를 제공합니다. 선택적 의존이 누락 될 때 우아한 분해를 지원합니다. : 100 % MCP 서버 기능의 전체 기능을 갖춘 CLI를 포함합니다. - Xcode가 설치된 macOS - Node.
개요(AI 번역)
Apple’s 공식 Xcode MCP: Apple은 이제 공식 Xcode MCP 서버를 제공합니다. XcodeMCP는 sidekick mode (
--sidekick-only])에 따라 실행할 수 있으며 프로젝트 관리 및 XCResult 분석과 같은 보완 도구를 제공합니다. 향후 버전에서 XcodeMCP는 기본적으로 Sidekick-only 모드로 전환합니다. 아래 설정 참조.
XcodeMCP를
Model Context Protocol (MCP) 서버는 Xcode를 자동화 (JXA)를 통해 직접 제어합니다. MCP 서버와 독립 CLI 모두 가능
무엇 그것
- 자동화용 JavaScript를 통해 Xcode를 직접 제어(xcodebuild CLI)
- Xcode 내에서 프로젝트, 빌드, 실행, 테스트 및 디버그를 엽니다.
- XCLogParser를 사용하여 정확한 오류 위치와 로그 구축
- 포괄적인 환경 검증 및 건강 검사 제공
- 선택적 종속이 누락될 때 우아한 degradation 지원
- NEW: 100 % MCP 서버 기능 패니티를 갖춘 전체 기능을 갖춘 CLI를 포함합니다.
요구 사항
- Xcode가 설치된 macOS
- 노드.js 18+
- XCLogParser (추천) :
brew install xclogparser
사용법
XcodeMCP는 2가지 방법으로 사용될 수 있습니다:
- 명세.
이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요.
README
원문 README의 일부입니다. 원문 보기.
Using with Apple’s Official Xcode MCP: Apple now provides an official Xcode MCP server. XcodeMCP can run alongside it in sidekick mode (
--sidekick-only), providing complementary tools like project management and XCResult analysis. In a future version, XcodeMCP will transition to sidekick-only mode by default. See configuration below.
XcodeMCP
Model Context Protocol (MCP) server that controls Xcode directly through JavaScript for Automation (JXA). Available as both an MCP server and a standalone CLI.
What it does
- Controls Xcode directly through JavaScript for Automation (not xcodebuild CLI)
- Opens projects, builds, runs, tests, and debugs from within Xcode
- Parses build logs with precise error locations using XCLogParser
- Provides comprehensive environment validation and health checks
- Supports graceful degradation when optional dependencies are missing
- NEW: Includes a full-featured CLI with 100% MCP server feature parity
Requirements
- macOS with Xcode installed
- Node.js 18+
- XCLogParser (recommended):
brew install xclogparser
Usage
XcodeMCP can be used in two ways:
- MCP Server: Integrate with Claude Desktop, VS Code, or other MCP clients
- CLI Tool: Run commands directly from the terminal with
xcodecontrol
Quick Install
XCLogParser is recommended but optional:
brew install xclogparser
Install from npm
Run directly with npx:
npx -y xcodemcp@latest
Or install globally:
npm install -g xcodemcp
MCP Configuration
Add to your MCP configuration:
{
"mcpServers": {
"xcodemcp": {
"command": "npx",
"args": ["-y", "xcodemcp@latest"],
"env": {
}
}
}
}
설치
npx -y xcodemcp@latest설정
{
"mcpServers": {
"xcodemcp": {
"command": "npx",
"args": ["-y", "xcodemcp@latest"],
"env": {
}
}
}
}