Lets an AI client build, test, and manage Xcode projects and iOS simulators from the command line or MCP tools.
別名 getsentry/XcodeBuildMCP, @mseep/xcodebuildmcp
- スター
- 6,569
- ツール
- —
- ダウンロード数（30日間）
- —
- 最新バージョン
- 2.7.0
- 最終コミット
- 2026年11月13日
- ライセンス
- MIT
XcodeBuildMCP MCPとは
XcodeBuildMCPはMCPサーバーです。 Lets an AI client build, test, and manage Xcode projects and iOS simulators from the command line or MCP tools.
プロジェクトのREADMEから生成された概要
XcodeBuildMCP MCP server について
Managing iOS and macOS development tasks from an AI coding agent is what XcodeBuildMCP enables. It provides a bridge between AI clients and the command line, allowing agents to build, test, and manage Xcode projects and iOS simulators directly. Developers can use it as a dedicated MCP server for agents or as a standalone CLI for manual terminal operations.
To use this tool, you need macOS 14.5 or later, Xcode 16.x or later, and Node.js 18.x if installing via npm. It can be installed through Homebrew or npm, and it supports integration with clients like Claude Code, Cursor, and Codex. The server includes specific logic to skip macro validation during builds to prevent errors when working with Swift Macros. For hardware-specific tasks, users must ensure code signing is configured in Xcode for device tools.
できること
- 1Build projects for simulatorsAsk your AI agent to compile a specific scheme for an iPhone simulator.
- 2Prepare portable test productsInstruct an agent to generate test products without immediately running them.
- 3Execute automated testingHave an AI client run previously prepared test products on a specific simulator name.
プロジェクトの README から作成されています。すべてのユースケースは、その引用と照らし合わせて確認されています。
XcodeBuildMCP MCPのインストール方法
フォーマット検証日 2026年11月10日Claude CodeにXcodeBuildMCP MCPをインストール
$ claude mcp add xcodebuildmcp -- npx -y xcodebuildmcpCursorにXcodeBuildMCP MCPをインストール
~/.cursor/mcp.json
{
"mcpServers": {
"xcodebuildmcp": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp"
]
}
}
}VS CodeにXcodeBuildMCP MCPをインストール
.vscode/mcp.json
{
"servers": {
"xcodebuildmcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"xcodebuildmcp"
]
}
}
}Claude DesktopにXcodeBuildMCP MCPをインストール
claude_desktop_config.json
{
"mcpServers": {
"xcodebuildmcp": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp"
]
}
}
}CodexにXcodeBuildMCP MCPをインストール
~/.codex/config.toml
[mcp_servers.xcodebuildmcp] command = "npx" args = ["-y", "xcodebuildmcp"]
Gemini CLIにXcodeBuildMCP MCPをインストール
~/.gemini/settings.json
{
"mcpServers": {
"xcodebuildmcp": {
"command": "npx",
"args": [
"-y",
"xcodebuildmcp"
]
}
}
}設定
INCREMENTAL_BUILDS_ENABLEDEnable experimental xcodemake incremental builds (true/false or 1/0).
XCODEBUILDMCP_DEBUGEnable verbose debug logging from the server.
XCODEBUILDMCP_ENABLED_WORKFLOWSComma-separated list of workflows to load at startup (e.g., 'simulator,device,project-discovery').
XCODEBUILDMCP_SENTRY_DISABLEDDisable Sentry error reporting (preferred flag).
| 名前 | 説明 | 種類 |
|---|---|---|
| INCREMENTAL_BUILDS_ENABLED | Enable experimental xcodemake incremental builds (true/false or 1/0). | |
| XCODEBUILDMCP_DEBUG | Enable verbose debug logging from the server. | |
| XCODEBUILDMCP_ENABLED_WORKFLOWS | Comma-separated list of workflows to load at startup (e.g., 'simulator,device,project-discovery'). | |
| XCODEBUILDMCP_SENTRY_DISABLED | Disable Sentry error reporting (preferred flag). |
自動チェック
実行日 2026年11月11日詳細レポート →自動チェックに合格しました。これはセキュリティ監査ではありません。コードを読み、サーバーに必要最小限のアクセス権を与えてください。 チェックの仕組み
- ソースリポジトリがリンクされており、アクセス可能合格
- オープンソースライセンス (OSI)合格
- 過去1年以内にコミットまたはリリースあり合格
- パッケージ名が有名なパッケージに酷似していない合格
- リモートエンドポイントがHTTPSを使用未チェック
- 破壊的なツールがラベル付けされている未チェック
- モデルへの隠れた指示がない合格
- パッケージと依存関係に重大なアドバイザリがない合格
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.
XcodeBuildMCP MCPのよくある質問
XcodeBuildMCP MCPをClaude Codeに追加するには
ターミナルでclaude mcp add xcodebuildmcp -- npx -y xcodebuildmcpを実行します。すべてのプロジェクトで利用するには--scope userを追加します。
XcodeBuildMCP MCPをCursorに追加するには
~/.cursor/mcp.jsonを開き、上記のインストールセクションに示すCursor設定を使ってmcpServersの下にサーバーを追加します。
What does XcodeBuildMCP do?
It provides tools for agent use when working on iOS and macOS projects, including building for simulators and running prepared test products.
How do I install XcodeBuildMCP?
Install it via Homebrew with brew tap getsentry/xcodebuildmcp and brew install mobilebuildmcp, or via npm with npm install -g mobilebuildmcp@latest.
What are the requirements for XcodeBuildMCP?
It requires macOS 14.5 or later, Xcode 16.x or later, and Node.js 18.x or later (Node is not required for Homebrew installation).
Can I run XcodeBuildMCP without a global install?
Yes, most MCP clients can run the server on demand via npx -y mobilebuildmcp@latest mcp.