LX

lapfelix/xcodemcp

Developer tools

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

59 stars 4 forks 품질 76 트렌드 13Apache-2.0

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가지 방법으로 사용될 수 있습니다:

  1. 명세.

이 페이지는 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:

  1. MCP Server: Integrate with Claude Desktop, VS Code, or other MCP clients
  2. 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": {
      }
    }
  }
}
GitHub에서 전체 README 보기

설치

npx -y xcodemcp@latest
MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{ "mcpServers": { "xcodemcp": { "command": "npx", "args": ["-y", "xcodemcp@latest"], "env": { } } } }