lapfelix/xcodemcp

Developer tools

このページは AI により自動翻訳されています。技術的な詳細は原文をご確認ください。原文を見る

59 stars 4 forks 品質 76 トレンド 13Apache-2.0

Repository Install

AppleScript インターフェイスをラップし、XCLogParser を使用して、Xcode 用の MCP サーバーで、明確なビルド結果を返す

概要

: Appleは公式のXcode MCPサーバーを提供します。 XcodeMCP は、プロジェクト管理や XCResult 解析などの補完的なツールを (-sidekick-only) で実行できます。将来のバージョンでは、XcodeMCP はデフォルトでサイドキックのみモードに移行します。下記の設定を参照してください。モデルコンテキストプロトコル (MCP) サーバは、自動化 (JXA) の JavaScript から直接 Xcode を制御します。 MCP サーバーとスタンドアローン CLI の両方でご利用いただけます。 - 自動化のためにJavaScriptを使用してXcodeを直接制御(xcodebuild CLIではありません) - Xcode内のプロジェクトを開き、ビルド、実行、テスト、およびデバッグを開きます - パースは、XCLogParserを使用して正確なエラー位置でビルドログをビルド - 包括的な環境検証と健康チェックを提供します - オプションの依存関係が欠落しているときの恵みのある劣化をサポート - : 完全な機能のCLIを100% MCPサーバー機能パリティが含まれています - XcodeがインストールされているmacOS - Node.

概要（AI 翻訳）

Appleの公式Xcode MCPの使用: Appleは公式のXcode MCPサーバーを提供します。 XcodeMCP は、sidekick モード ([--sidekick-only) で実行でき、プロジェクト管理やXCResult 解析などの補完ツールを提供しています。将来のバージョンでは、XcodeMCP はデフォルトでサイドキックのみモードに移行します。下記の設定を参照してください。

XcodeMCPの

モデルコンテキストプロトコル (MCP) サーバは、自動化 (JXA) の JavaScript から直接 Xcode を制御します。 MCP サーバーとスタンドアローン CLI の両方でご利用いただけます。

それが何をするか

自動化のためのJavaScriptを使用して直接Xcodeを制御する(xcodebuild CLIではなく)
Xcode内でプロジェクト、ビルド、実行、テスト、デバッグを開く
XCLogParser を使用して正確なエラー位置でビルドログをパース
包括的な環境検証と健康チェックを提供
オプションの依存関係が見つからない場合、優雅な劣化をサポート -新しい: 100% MCP サーバー機能を持つCLIをフル機能搭載

要件

XcodeがインストールしたmacOS
Node.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:

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": {
      }
    }
  }
}

GitHub で README 全文を見る

インストール

npx -y xcodemcp@latest

MCP 初心者？mcpskill.org のガイドから始めましょう →

設定

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