MCP.so
登录

XcodeMCP

@lapfelix

代码仓库

关于 XcodeMCP

MCP server for Xcode that wraps its AppleScript interface & uses XCLogParser to return clear build results

基本信息

分类

其他

许可证

Apache-2.0

运行时

node

传输方式

stdio

发布者

lapfelix

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

22

Open projects and workspaces

Get workspace status and details

List projects in workspace

Open files with optional line number

Build with detailed error parsing

Clean build artifacts

Run tests with optional arguments

Build and run the active scheme

Start debugging session

Stop current operation

List available schemes

Switch active scheme

List simulators and devices

Browse test results and analyze failures

Get console output for specific tests

Quick overview of test results

Extract screenshots from test failures

Get UI hierarchy as AI-readable JSON with timestamp selection

Get detailed properties of specific UI elements by index

List all attachments for a test

Export specific attachments from test results

Environment validation and troubleshooting

概览

What is XcodeMCP?

XcodeMCP is a Model Context Protocol (MCP) server and standalone CLI that controls Xcode directly through JavaScript for Automation (JXA). It provides tools for building, running, testing, debugging, parsing build logs, analyzing XCResult files, and validating the environment. It can run alongside Apple’s official Xcode MCP server in sidekick mode to offer complementary tools.

How to use XcodeMCP?

Install via npx -y xcodemcp@latest or globally with npm install -g xcodemcp. Use it as an MCP server by adding a JSON configuration to MCP clients (Claude Desktop, VS Code, etc.) or as a CLI tool with the xcodecontrol command. For side-by-side use with Apple’s official Xcode MCP, start with --sidekick-only to exclude build/run/test/debug tools. Optional but recommended: install XCLogParser via brew install xclogparser. Requirements: macOS with Xcode and Node.js 18+.

Key features of XcodeMCP

  • Controls Xcode directly through JXA (not xcodebuild CLI)
  • XCResult analysis with screenshot extraction and UI hierarchy
  • Build log parsing with XCLogParser for precise error locations
  • Comprehensive health checks and environment validation
  • Sidekick mode to complement Apple’s official Xcode MCP
  • Full‑featured CLI with 100% MCP server feature parity

Use cases of XcodeMCP

  • Build and run Xcode projects from an AI coding assistant
  • Run tests, browse results, and extract debug attachments
  • Manage project schemes and workspaces programmatically
  • Debug sessions and stop current operations
  • Analyze test failures with console logs and UI hierarchy snapshots

FAQ from XcodeMCP

What is sidekick mode?

Sidekick mode (--sidekick-only) includes only project management and XCResult analysis tools, excluding build/run/test/debug operations. It is designed to work alongside Apple’s official Xcode MCP server without duplicating functionality.

How can I use XcodeMCP alongside Apple’s official Xcode MCP?

Enable Xcode Tools in Xcode settings, then add Apple’s MCP with xcrun mcpbridge and XcodeMCP with --sidekick-only to your MCP configuration. The README provides JSON and Claude Code CLI examples for both servers.

Can I set preferred values to avoid repetitive parameters?

Yes. Use environment variables XCODE_MCP_PREFERRED_SCHEME and XCODE_MCP_PREFERRED_XCODEPROJ to make tool parameters optional, defaulting to those values. They can still be overridden explicitly.

What are the system requirements?

macOS with Xcode installed, Node.js 18 or later, and optionally XCLogParser (recommended for build log parsing). No other runtime dependencies are required.

How do I troubleshoot if the MCP fails in Claude Code?

Run npx -y xcodemcp@latest manually from the project folder to see any error output. Common issues include missing Node.js, Xcode, or permission problems.

评论

其他 分类下的更多 MCP 服务器

EverArt

modelcontextprotocol

Model Context Protocol Servers

88.1K

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Nginx UI

0xJacky

Yet another WebUI for Nginx

11.3K

Activepieces

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Agents

23.2K

Mcp

browsermcp

Browser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

6.8K