MCP.Market

Xcodemcp MCP server

by lapfelix·io.github.lapfelix/xcodemcp·v2.1.4·58 stars
No reviews yet

Control Xcode directly via JXA for build, test, debug operations with XCLogParser integration

B75/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B75/100

full report

Adoption
Growing

58 stars60 downloads/wk

Reviews

Write one

Nobody has reviewed Xcodemcp yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Xcodemcp tools (26, 3 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • find_xcresults

    Find all XCResult files for a specific project with timestamps and file information

  • xcode_build

    Build a specific Xcode project or workspace with the specified scheme. If destination is not provided, uses the currently active destination.

  • xcode_build_and_runwrite action

    Build and run a specific project with the specified scheme

  • xcode_clean

    Clean the build directory for a specific project

  • xcode_close_project

    Close the currently active Xcode project or workspace (automatically stops any running actions first)

  • xcode_debug

    Start debugging session for a specific project

  • xcode_get_projects

    Get list of projects in a specific workspace

  • xcode_get_run_destinationswrite action

    Get list of available run destinations for a specific project

  • xcode_get_schemes

    Get list of available schemes for a specific project

  • xcode_get_test_targets

    Get information about test targets in a project, including names and identifiers

  • xcode_get_workspace_info

    Get information about a specific workspace

  • xcode_health_check

    Perform a comprehensive health check of the XcodeMCP environment and configuration

  • xcode_open_file

    Open a file in Xcode

  • xcode_open_project

    Open an Xcode project or workspace

  • xcode_refresh_project

    Refresh/reload an Xcode project by closing and reopening it to pick up external changes like modified .xctestplan files

  • xcode_set_active_scheme

    Set the active scheme for a specific project

  • xcode_stop

    Stop the current scheme action

  • xcode_testwrite action

    Run tests for a specific project

  • xcresult_browse

    Browse XCResult files - list all tests or show details for a specific test. Returns comprehensive test results including pass/fail status, failure details, and browsing instructions. Large console output (>20 lines or >2KB) is automatically saved to a temporary file.

  • xcresult_browser_get_console

    Get console output and test activities for a specific test in an XCResult file. Large output (>20 lines or >2KB) is automatically saved to a temporary file.

  • xcresult_export_attachment

    Export a specific attachment by index - can convert App UI hierarchy attachments to JSON

  • xcresult_get_screenshot

    Get screenshot from a failed test at specific timestamp - extracts frame from video attachment using ffmpeg

  • xcresult_get_ui_element

    Get full details of a specific UI element by index from a previously exported UI hierarchy JSON file

  • xcresult_get_ui_hierarchy

    Get UI hierarchy attachment from test. Returns raw accessibility tree (best for AI), slim AI-readable JSON (default), or full JSON.

  • xcresult_list_attachments

    List all attachments for a specific test - shows attachment names, types, and indices for export

  • xcresult_summary

    Get a quick summary of test results from an XCResult file

Public scan report

scanner v0.1.10 · 2026-10-01 · same rubric, same numbers if you re-run it

no findings
  • Code scan41 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitylocal package, no credentials required12/15
  • Maintenancelast push 239 days ago4/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 75/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Xcodemcp compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
75/100
higher than 45% of 48,273 servers
Tools
26
the typical server has 7
Tools that change things
12%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
58
more than 95% of 28,534 servers
Downloads a week
60
more than 51% of 11,915 servers with a package

What its tools let an agent do: 23 read · 3 change

Install Xcodemcp in Claude Code, Cursor or VS Code

Runs npx -y xcodemcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add xcodemcp -- npx -y xcodemcp
Add to Cursor

What the publisher says

From the Xcodemcp repository's README, as published. We do not edit it. Read it on GitHub

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

Claude Code CLI Setup

To add XcodeMCP to Claude Code using the command line:

claude mcp add-json XcodeMCP '{
  "command": "npx",
  "args": ["-y", "xcodemcp@latest"],
  "env": {
  }
}'

Without the clean build folder tool

To add XcodeMCP to Claude Code using the command line:

claude mcp add-json XcodeMCP '{
  "command": "npx",
  "args": ["-y", "xcodemcp@latest", "--no-clean"],
  "env": {
  }
}'

Using Preferred Values for Single Project Workflows

For projects where you're working with a single xcodeproj and scheme, you can configure preferred values to make tool parameters optional:

claude mcp add-json XcodeMCP '{
  "command": "npx",
  "args": ["-y", "xcodemcp@latest"],
  "env": {
    "XCODE_MCP_PREFERRED_SCHEME": "MyApp",
    "XCODE_MCP_PREFERRED_XCODEPROJ": "MyApp.xcodeproj"
  }
}'

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Xcodemcp: common questions

Is Xcodemcp MCP server safe?
Mostly: it is graded B (75/100). Read the Xcodemcp safety report
How do I install Xcodemcp?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Xcodemcp need an API key?
Not as far as the registry entry and our scan can tell: no credentials are declared or required.
Is Xcodemcp maintained?
The last commit was 270 days ago (2026-02-05). The latest release is v2.1.4.
What can I use instead of Xcodemcp?
Servers from other publishers that do the same job: Firefox DevTools MCP server.
How does Xcodemcp compare with other MCP servers?
safety score 75/100 (higher than 45% of 48,273 servers); tools 26 (the typical server has 7); tools that change things 12% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Xcodemcp

Same job from other publishers: the closest match first, then the best rated.

  • Firefox DevTools MCP
    Control and debug Firefox: navigate, fill forms, inspect network and console, profile.
    A