Supports building and testing for iOS platforms and simulators, facilitating the analysis of mobile application build outputs and diagnostics.
Facilitates structured access to macOS-native development tools, providing token-efficient analysis of build logs and compiler output for Apple ecosystem projects.
Enables execution and parsing of Swift Package Manager commands like build and test, with support for extracting test failures and code coverage data.
Provides tools for executing Xcode build actions and parsing raw output into structured formats, enabling AI assistants to extract errors, warnings, and test failures.
Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@xcsift-mcp run swift build and show me the errors"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
An MCP (Model Context Protocol) server that wraps xcsift, enabling AI coding assistants to parse Xcode build output into structured, token-efficient formats.
xcsift-mcp provides AI coding assistants (like Claude, OpenCode, Cursor, etc.) with tools to:
Parse raw xcodebuild or swift build/test output into structured JSON or TOON format
Execute build commands and get parsed results automatically
Extract errors, warnings, test failures, and linker errors with file/line information
Analyze code coverage from test runs
The output is optimized for token efficiency, with TOON format providing 30-60% fewer tokens compared to JSON.
Related MCP server: XcodeMCP
Python 3.10+
macOS (xcsift is macOS-only)
pipx (install via brew install pipx)
git clone https://github.com/johnnyclem/xcsift_mcp.git
cd xcsift_mcp
pipx install -e ".[dev]"brew install johnnyclem/xcsift-mcp/xcsift-mcpThe server will automatically download the xcsift binary from GitHub releases on first run if it's not already installed. The binary is cached in ~/.local/share/xcsift-mcp/bin/.
You can also install it manually via Homebrew:
brew install xcsift# Run with stdio transport (default, for Claude Desktop/OpenCode)
xcsift-mcp
# Run with HTTP transport (for debugging/web clients)
xcsift-mcp --transport http --port 8000Add to your claude_desktop_config.json:
{
"mcpServers": {
"xcsift": {
"command": "xcsift-mcp"
}
}
}Add to your opencode.json (or opencode.jsonc):
{
"mcp": {
"xcsift": {
"type": "local",
"command": ["xcsift-mcp"]
}
}
}Alternatively, run opencode mcp add and follow the interactive prompts.
Add to your MCP configuration in Cursor settings, or add to .cursor/mcp.json:
{
"mcpServers": {
"xcsift": {
"command": "xcsift-mcp"
}
}
}Tool | Description |
| Parse raw xcodebuild/swift output into JSON or TOON format |
| Extract only errors with file/line information |
| Extract only warnings with file/line/type |
| Extract failed tests with assertion messages |
| Get a quick summary with error/warning counts |
Tool | Description |
| Run xcodebuild and parse output automatically |
| Run swift build for SPM projects |
| Run swift test with optional coverage |
| Run arbitrary build commands and parse output |
parse_xcodebuild_outputParameter | Type | Default | Description |
| string | required | Raw xcodebuild/swift output (use |
|
|
| Output format |
| bool |
| Include detailed warnings list |
| bool |
| Include coverage data if available |
xcodebuildParameter | Type | Default | Description |
|
|
| Build action |
| string | none | Scheme to build |
| string | none | Path to .xcodeproj |
| string | none | Path to .xcworkspace |
| string | none | Destination (e.g., |
|
| none | Build configuration |
| bool |
| Enable coverage for tests |
|
|
| Output format |
| int |
| Timeout in seconds |
swift_buildParameter | Type | Default | Description |
|
|
| Build configuration |
| string | none | Path to Swift package |
| string | none | Specific target to build |
|
|
| Output format |
| int |
| Timeout in seconds |
swift_testParameter | Type | Default | Description |
| string | none | Path to Swift package |
| string | none | Filter tests (e.g., |
| bool |
| Enable coverage collection |
| bool |
| Run tests in parallel |
|
|
| Output format |
| int |
| Timeout in seconds |
# In your AI assistant
result = parse_xcodebuild_output(
output="<raw xcodebuild output>",
format="toon", # or "json"
include_warnings=True
)result = xcodebuild(
action="build",
scheme="MyApp",
destination="platform=iOS Simulator,name=iPhone 15",
output_format="json"
)result = swift_test(
enable_code_coverage=True,
output_format="toon"
)errors = extract_errors(output="<raw xcodebuild output>")
# Returns: [{"file": "main.swift", "line": 15, "message": "..."}]Standard structured JSON output:
{
"status": "failed",
"summary": {
"errors": 1,
"warnings": 3,
"failed_tests": 0,
"linker_errors": 0,
"build_time": "3.2s"
},
"errors": [
{
"file": "main.swift",
"line": 15,
"message": "use of undeclared identifier 'unknown'"
}
],
"warnings": [
{
"file": "view.swift",
"line": 20,
"message": "variable 'temp' was never used",
"type": "compile"
}
]
}30-60% fewer tokens than JSON:
status: failed
summary:
errors: 1
warnings: 3
failed_tests: 0
linker_errors: 0
build_time: 3.2s
errors[1]{file,line,message}:
main.swift,15,"use of undeclared identifier 'unknown'"
warnings[1]{file,line,message,type}:
view.swift,20,"variable 'temp' was never used","compile"When to use each format:
JSON: When you need to parse the output programmatically or integrate with other tools
TOON: When sending to an LLM to reduce token usage and API costs
Resource URI | Description |
| xcsift version and installation info |
| Example .xcsift.toml configuration |
| Documentation about output formats |
| Comprehensive help documentation |
Prompt | Description | Arguments |
| Template for analyzing build failures |
|
| Template for fixing Swift/ObjC compiler errors |
|
| Template for improving test coverage |
|
| Template for debugging test failures |
|
| Template for fixing linker errors |
|
| Template for analyzing build performance |
|
pytestpytest --cov=xcsift_mcpruff format .
ruff check .xcsift_mcp/
├── src/xcsift_mcp/
│ ├── __init__.py # Package init
│ ├── __main__.py # Entry point
│ ├── server.py # FastMCP server
│ ├── xcsift_installer.py # Auto-download xcsift
│ ├── resources.py # MCP resources
│ ├── prompts.py # Prompt templates
│ └── tools/
│ ├── parse.py # Parsing tools
│ └── build.py # Build execution tools
├── tests/
│ ├── fixtures/ # Sample build outputs
│ └── test_*.py # Test files
├── pyproject.toml
└── README.md┌─────────────────────────────────────────────────────────────────┐
│ AI Assistant (Claude, OpenCode, etc.) │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ MCP Protocol (stdio/HTTP) │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ xcsift MCP Server (Python) │
│ ┌─────────────────┐ ┌──────────────────┐ ┌────────────────┐ │
│ │ Tools (9) │ │ Resources (4) │ │ Prompts (6) │ │
│ │ - parse_output │ │ - version │ │ - analyze │ │
│ │ - xcodebuild │ │ - config │ │ - fix_errors │ │
│ │ - swift_build │ │ - formats │ │ - coverage │ │
│ │ - swift_test │ │ - help │ │ - debug │ │
│ └─────────────────┘ └──────────────────┘ └────────────────┘ │
└─────────────────────────────────────────────────────────────────┘
│
▼
┌─────────────────────────────────────────────────────────────────┐
│ xcsift CLI (subprocess) │
└─────────────────────────────────────────────────────────────────┘If xcsift cannot be downloaded automatically, install it manually:
brew install xcsiftEnsure the xcsift binary has execute permissions:
chmod +x ~/.local/share/xcsift-mcp/bin/xcsiftIncrease the timeout parameter for long builds:
xcodebuild(scheme="MyApp", timeout=1200) # 20 minutesMIT License - see LICENSE for details.
xcsift - The Swift CLI tool that does the actual parsing
MCP Python SDK - Model Context Protocol implementation
This server cannot be installed
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to interact with yo…
MCP server for AI agents to plan, verify, and deploy Cloudflare-native apps.
MCP server for generating rough-draft project plans from natural-language prompts.
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/johnnyclem/xcsift-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server