AI 에이전트가 MCP 도구 또는 CLI를 통해 iOS 및 macOS Xcode 프로젝트를 빌드, 테스트 및 관리할 수 있게 합니다.
다른 이름 getsentry/MobileBuildMCP
- 스타
- 6,573
- Tools
- 24
- 다운로드, 30일
- —
- 최신 버전
- —
- 마지막 커밋
- 2026년 11월 13일
- 라이선스
- MIT
MobileBuildMCP MCP란?
AI 에이전트가 MCP 도구 또는 CLI를 통해 iOS 및 macOS Xcode 프로젝트를 빌드, 테스트 및 관리할 수 있게 합니다. 24개 도구를 제공합니다. 예: session_show_defaults, session_use_defaults_profile, session_set_defaults.
프로젝트 README에서 생성된 요약
MobileBuildMCP MCP server 정보
MobileBuildMCP는 AI 에이전트를 통해 iOS 및 macOS 개발 워크플로우를 관리할 수 있게 해줍니다. AI 코딩 어시스턴트와 Xcode 사이의 가교 역할을 하여 에이전트가 프로젝트를 직접 빌드, 테스트 및 관리할 수 있도록 지원합니다. 개발자는 이를 Claude Code 또는 Cursor와 같은 클라이언트를 위한 전용 MCP server로 사용하거나 통합 명령줄 인터페이스를 통해 상호작용할 수 있습니다.
설치는 Homebrew 또는 npm을 통해 가능하며, 시스템에는 macOS 14.5 이상과 Xcode 16.x가 필요합니다. 이 도구는 Swift Macros를 사용하는 프로젝트에서 오류가 발생하지 않도록 빌드 중 매크로 검증을 건너뛰는 특정 로직을 포함하고 있습니다. CLI 사용자의 경우, 워크스페이스별 데몬이 로그 캡처 및 디버깅과 같은 상태 유지 작업을 처리합니다. 서버는 에이전트 중심의 사용을 위해 설계되었지만, 수동 프로젝트 관리를 위한 표준 터미널 도구로도 작동합니다.
활용 사례
- 1시뮬레이터용 프로젝트 빌드AI 에이전트에게 시뮬레이터 타겟용 특정 Xcode scheme을 컴파일하도록 요청합니다.
- 2테스트 제품 준비에이전트에게 테스트를 즉시 실행하지 않고 휴대 가능한 테스트 제품을 생성하도록 지시합니다.
- 3자동화된 테스트 실행AI가 이전에 준비된 테스트 제품을 특정 시뮬레이터 이름에서 실행하도록 합니다.
- 4소프트웨어 업데이트 관리CLI를 사용하여 도구의 버전 업그레이드를 확인하고 적용합니다.
프로젝트의 README를 바탕으로 작성되었습니다. 모든 활용 사례는 해당 내용의 인용문과 대조하여 확인합니다.
MobileBuildMCP MCP 설치 방법
형식 확인: 2026년 11월 10일Cursor에 추가Goose에 추가Claude Code에 MobileBuildMCP MCP 설치
$ claude mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcpCursor에 MobileBuildMCP MCP 설치
~/.cursor/mcp.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}VS Code에 MobileBuildMCP MCP 설치
.vscode/mcp.json
{
"servers": {
"mobilebuildmcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}VS Code CLI에 MobileBuildMCP MCP 설치
$ code --add-mcp '{"name":"mobilebuildmcp","type":"stdio","command":"npx","args":["-y","mobilebuildmcp","mcp"]}'Claude Desktop에 MobileBuildMCP MCP 설치
claude_desktop_config.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}Codex에 MobileBuildMCP MCP 설치
$ codex mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcpCodex config.toml에 MobileBuildMCP MCP 설치
~/.codex/config.toml
[mcp_servers.mobilebuildmcp] command = "npx" args = ["-y", "mobilebuildmcp", "mcp"]
Gemini CLI에 MobileBuildMCP MCP 설치
$ gemini mcp add -s user mobilebuildmcp npx -- -y mobilebuildmcp mcpGemini settings.json에 MobileBuildMCP MCP 설치
~/.gemini/settings.json
{
"mcpServers": {
"mobilebuildmcp": {
"command": "npx",
"args": [
"-y",
"mobilebuildmcp",
"mcp"
]
}
}
}HostedMCP가 2026년 11월 16일에 실행 확인
mobilebuildmcp 2.7.1을(를) 네트워크와 키가 없는 격리된 컨테이너에서 이 명령으로 실행했습니다. 응답하며 도구 24개를 보여 주었습니다.
MobileBuildMCP MCP 도구 24
tools/list로 서버에서 직접 읽음session_show_defaults읽기 전용Show current active defaults. Required before your first build/run/test call in a session — do not assume defaults are configured.
session_use_defaults_profile작업Switch the active session defaults profile.
session_set_defaults작업Set session defaults for the active profile, or for a specified profile and make it active.
session_clear_defaults작업Clear session defaults for the active profile or a specified profile.
list_sims읽기 전용List iOS simulators.
boot_sim작업Boot iOS simulator for manual/non-build flows. Not required before simulator build-and-run (build_run_sim).
open_sim읽기 전용Open the simulator frontend for visibility and manual workflows. Not required before simulator build-and-run (build_run_sim).
build_sim작업Build for iOS sim (compile-only, no launch).
build_run_sim작업Build, install, and launch on iOS Simulator, booting it when needed. Runtime logs are captured automatically and the log file path is included in the response. Preferred single-step run tool when defaults are set.
test_sim작업Test on iOS sim.
get_sim_app_path읽기 전용Get sim built app path.
install_app_sim작업Install app on sim.
| session_show_defaults | Show current active defaults. Required before your first build/run/test call in a session — do not assume defaults are configured. | 읽기 전용 |
| session_use_defaults_profile | Switch the active session defaults profile. | 작업 |
| session_set_defaults | Set session defaults for the active profile, or for a specified profile and make it active. | 작업 |
| session_clear_defaults | Clear session defaults for the active profile or a specified profile. | 작업 |
| list_sims | List iOS simulators. | 읽기 전용 |
| boot_sim | Boot iOS simulator for manual/non-build flows. Not required before simulator build-and-run (build_run_sim). | 작업 |
| open_sim | Open the simulator frontend for visibility and manual workflows. Not required before simulator build-and-run (build_run_sim). | 읽기 전용 |
| build_sim | Build for iOS sim (compile-only, no launch). | 작업 |
| build_run_sim | Build, install, and launch on iOS Simulator, booting it when needed. Runtime logs are captured automatically and the log file path is included in the response. Preferred single-step run tool when defaults are set. | 작업 |
| test_sim | Test on iOS sim. | 작업 |
| get_sim_app_path | Get sim built app path. | 읽기 전용 |
| install_app_sim | Install app on sim. | 작업 |
도구 24개 모두 보기도구 수 줄이기
launch_app_sim작업Launch app on simulator. Runtime logs are captured automatically and the log file path is included in the response.
stop_app_sim작업Stop sim app.
record_sim_video작업Record sim video.
clean작업Clean build products.
discover_projs읽기 전용Scans a directory (defaults to workspace root) to find Xcode project (.xcodeproj) and workspace (.xcworkspace) files. Use when project/workspace path is unknown.
list_schemes읽기 전용List Xcode schemes.
show_build_settings읽기 전용Show build settings.
get_app_bundle_id읽기 전용Extract bundle id from .app.
screenshot읽기 전용Capture screenshot.
snapshot_ui읽기 전용Capture a semantic rs/1 runtime UI snapshot with elementRef targets. Observe once, use tap for one target or batch for multiple same-screen targets, and refresh after navigation, scrolling, sheet changes, or obvious layout changes.
get_coverage_report읽기 전용Show per-target code coverage from an xcresult bundle.
get_file_coverage읽기 전용Show function-level coverage and uncovered line ranges for a specific file.
| launch_app_sim | Launch app on simulator. Runtime logs are captured automatically and the log file path is included in the response. | 작업 |
| stop_app_sim | Stop sim app. | 작업 |
| record_sim_video | Record sim video. | 작업 |
| clean | Clean build products. | 작업 |
| discover_projs | Scans a directory (defaults to workspace root) to find Xcode project (.xcodeproj) and workspace (.xcworkspace) files. Use when project/workspace path is unknown. | 읽기 전용 |
| list_schemes | List Xcode schemes. | 읽기 전용 |
| show_build_settings | Show build settings. | 읽기 전용 |
| get_app_bundle_id | Extract bundle id from .app. | 읽기 전용 |
| screenshot | Capture screenshot. | 읽기 전용 |
| snapshot_ui | Capture a semantic rs/1 runtime UI snapshot with elementRef targets. Observe once, use tap for one target or batch for multiple same-screen targets, and refresh after navigation, scrolling, sheet changes, or obvious layout changes. | 읽기 전용 |
| get_coverage_report | Show per-target code coverage from an xcresult bundle. | 읽기 전용 |
| get_file_coverage | Show function-level coverage and uncovered line ranges for a specific file. | 읽기 전용 |
자동 검사
2026년 11월 16일에 실행됨전체 보고서 →자동 검사를 통과했습니다. 이는 보안 감사가 아닙니다. 코드를 직접 읽고 서버에 필요한 최소한의 권한만 부여하십시오. 검사 방식
- 소스 저장소 연결 및 접근 가능getsentry/mobilebuildmcp is public and reachablegithub.com/getsentry/mobilebuildmcp ↗통과
- 패키지가 이 저장소를 소스로 명시mobilebuildmcp names getsentry/mobilebuildmcp as sourcenpmjs.com/package/mobilebuildmcp ↗통과
- 빌드 출처(Sigstore 증명)Sigstore attestation for mobilebuildmcpnpmjs.com/package/mobilebuildmcp/v/2.7.1#provenance ↗통과
- 오픈 소스 라이선스 (OSI)MITspdx.org/licenses/MIT.html ↗통과
- 최근 1년 내 커밋 또는 릴리스Last commit or release 2026-11-13github.com/getsentry/mobilebuildmcp ↗통과
- OpenSSF Scorecard검사되지 않음
- 패키지 이름이 인기 패키지와 유사하지 않음No popular package one edit away from mobilebuildmcp통과
- 패키지 및 해당 종속성에 중요한 보안 권고 없음검사되지 않음
- 모델에 대한 숨겨진 지침 없음24 tool descriptions and the README read; no override phrases, credential paths or hidden characters통과
- 파괴적인 도구에 라벨 표시됨No tool named like delete, drop or exec통과
- 원격 엔드포인트가 MCP 핸드셰이크에 응답검사되지 않음
README
GitHub에서 보기A Model Context Protocol (MCP) server and CLI that provides tools for agent use when working on iOS and macOS projects.
Installation
MobileBuildMCP ships as a single package with two modes: a CLI for direct terminal use and an MCP server for AI coding agents. Either install method gives you both.
Option A — Homebrew
brew tap getsentry/xcodebuildmcp
brew install mobilebuildmcp
Option B — npm (Node.js 18+)
npm install -g mobilebuildmcp@latest
Verify either install:
mobilebuildmcp --help
Connect your MCP client
Drop-in config snippets for Cursor, Claude Code, Codex, can be found in the official docs page MCP Clients. Most clients can also run the MCP server on demand via npx -y mobilebuildmcp@latest mcp without a global install.
Requirements
- macOS 14.5 or later
- Xcode 16.x or later
- Node.js 18.x or later (not required for Homebrew installation)
Skills
MobileBuildMCP now includes two optional agent skills:
-
MCP Skill: Primes the agent with instructions on how to use the MCP server's tools (optional when using the MCP server).
-
CLI Skill: Primes the agent with instructions on how to navigate the CLI (recommended when using the CLI).
To install with a global binary:
mobilebuildmcp init
Or install directly via npx without a global install:
npx -y mobilebuildmcp@latest init
For further information on installing skills, see Agent Skills.
Notes
- MobileBuildMCP requests xcodebuild to skip macro validation to avoid errors when building projects that use Swift Macros.
- Device tools require code signing to be configured in Xcode. See Device Code Signing.
Privacy
MobileBuildMCP uses Sentry for internal runtime error telemetry only. For details and opt-out instructions, see Privacy & Telemetry.
CLI
MobileBuildMCP provides a unified command-line interface. The mcp subcommand starts the MCP server, while all other commands provide direct terminal access to tools:
# 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"
Check for updates and upgrade in place:
mobilebuildmcp upgrade --check
mobilebuildmcp upgrade --yes
The CLI uses a per-workspace daemon for stateful operations (log capture, debugging, etc.) that auto-starts when needed. See the CLI guide for full documentation.
Documentation
- Installation: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/installation.mdx
- Setup: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/setup.mdx
- MCP clients: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/clients.mdx
- CLI usage: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/cli.mdx
- Configuration and options: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/configuration.mdx
- Tools reference: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/tools.mdx
- Troubleshooting: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/troubleshooting.mdx
- Privacy: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/privacy.mdx
- Skills: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/skills.mdx
- Contributing: https://github.com/getsentry/xcodebuildmcp.com/blob/main/app/docs/_content/contributing.mdx
Licence
This project is licensed under the MIT License - see the LICENSE file for details. For third-party licensing notices see the THIRD_PARTY_LICENSES file for details. For npm package attributions see the THIRD_PARTY_PACKAGE_LICENSES file for details.
MobileBuildMCP MCP 질문
MobileBuildMCP MCP를 Claude Code에 추가하려면 어떻게 하나요?
터미널에서 claude mcp add mobilebuildmcp -- npx -y mobilebuildmcp mcp를 실행합니다. 모든 프로젝트에서 사용할 수 있게 하려면 --scope user를 추가합니다.
MobileBuildMCP MCP를 Cursor에 추가하려면 어떻게 하나요?
~/.cursor/mcp.json를 열고 mcpServers 아래에 서버를 추가합니다. 위 설치 섹션에 표시된 Cursor 구성을 사용합니다.
MobileBuildMCP MCP는 어떤 도구를 제공하나요?
24개 도구를 제공합니다. 예: session_show_defaults, session_use_defaults_profile, session_set_defaults, session_clear_defaults, list_sims.
MobileBuildMCP가 iOS 및 macOS 프로젝트에서 수행하는 역할은 무엇인가요?
에이전트가 시뮬레이터 빌드 및 테스트 제품을 포함하여 iOS 및 macOS용 Xcode 프로젝트를 빌드, 테스트 및 관리할 수 있도록 MCP 도구와 CLI 명령을 제공합니다.
MobileBuildMCP를 어떻게 설치하나요?
getsentry tap을 사용하여 Homebrew로 설치하거나 npm을 통해 mobilebuildmcp@latest를 전역으로 설치할 수 있습니다. 두 방법 모두 CLI와 MCP server를 제공합니다.
MobileBuildMCP의 시스템 요구 사항은 무엇인가요?
macOS 14.5 이상 및 Xcode 16.x 이상이 필요하며, Homebrew로 설치하지 않은 경우 Node.js 18.x 이상이 필요합니다.
MobileBuildMCP를 사용하여 명령줄에서 시뮬레이터용 빌드를 할 수 있나요?
네, CLI에는 scheme과 프로젝트 경로를 인자로 받는 시뮬레이터 빌드 명령이 포함되어 있습니다.
MobileBuildMCP는 텔레메트리를 전송하나요?
내부 런타임 오류 텔레메트리를 위해서만 Sentry를 사용하며, 문서에 거부(opt out) 방법이 설명되어 있습니다.