MMCPMarkets
LX

lapfelix/xcodemcp

开发工具

本页由 AI 翻译，技术细节请以原文为准。 查看原文

59 stars 4 forks 质量 76 趋势 13Apache-2.0
Repository Install

适用于 Xcode 的 MCP 服务器，其 AppleScript 接口封装并使用 XCLogParser 返回清晰的构建结果

概览

：苹果现已提供官方Xcode MCP服务器。XcodeMCP可与其并运行（仅限sidekick），提供项目管理和XCResult分析等互补工具。未来版本中，XcodeMCP将默认转为仅限sidekick模式。详见下方配置。 模型上下文协议（MCP）服务器，通过JavaScript自动化（JXA）直接控制Xcode。既有MCP服务器，也有独立CLI版本。 - 通过JavaScript for Automation（非xcodebuild CLI）直接控制Xcode——在Xcode内打开项目、构建、运行、测试和调试——使用XCLogParser解析带有精确错误位置的构建日志——提供全面的环境验证和健康检查——支持在缺少可选依赖时优雅降级——：包含一个功能齐全的CLI，且100%与MCP服务器功能一致。 - macOS 安装 Xcode - Node。

概述（AI 翻译）

与苹果官方 Xcode MCP 结合使用：苹果现提供官方 Xcode MCP 服务器。XcodeMCP 可以与其并运行 sidekick 模式（--sidekick-only），提供项目管理和 XCResult 分析等辅助工具。未来版本中，XcodeMCP 将默认转为仅 sidekick 模式。详见下方配置。

XcodeMCP

模型上下文协议（MCP）服务器，通过JavaScript自动化（JXA）直接控制Xcode。既有MCP服务器，也有独立CLI版本。

它的作用

  • 通过JavaScript for Automation（非xcodebuild CLI）直接控制Xcode。
  • 在 Xcode 内部打开项目、构建、运行、测试和调试
  • 解析器使用XCLogParser构建带有精确错误位置的日志
  • 提供全面的环境验证和健康检查
  • 当缺少可选依赖时，支持优雅降级
  • **新：包含功能齐全的CLI，且100%MCP服务器功能对齐

要求

  • 安装Xcode的macOS
  • Node.js 18+
  • XCLog解析器（推荐）：brew install xclogparser

用途

XcodeMCP 有两种使用方式： 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
新手？先看 mcpskill.org 教程 →

配置

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