XcodeBuild Mini MCP Server
Provides Xcode build operations including building schemes, listing and running tests, building tests, and listing packages in Xcode projects.
Click on "Deploy 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., "@XcodeBuild Mini MCP Server run tests for MyApp"
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.
XcodeBuild Mini MCP Server
An MCP (Model Context Protocol) server that provides Xcode build operations through the MCP interface, following the official MCP Node.js guide.
Features
This MCP server provides the following tools:
build - Build an Xcode scheme
list_tests - List all tests for an Xcode scheme
build_tests - Build tests for an Xcode scheme
run_tests - Run tests for an Xcode scheme (with optional test filtering)
list_packages - List all packages in the Xcode project
Related MCP server: Xcode MCP Server
Installation
Install dependencies:
npm installBuild the TypeScript code:
npm run buildUsage
Running the MCP Server
npm startOr for development:
npm run devMCP Client Configuration
To use this MCP server with an MCP client, add it to your client configuration:
{
"mcpServers": {
"xcodebuild-mini": {
"command": "npx",
"args": ["-y", "@roeybiran/xcodebuild-mini-mcp"],
}
}
}Available Tools
build
Build an Xcode scheme.
Parameters:
scheme(required): The Xcode scheme to buildwarn(optional): Show warnings in output (default: false)
Example:
{
"name": "build",
"arguments": {
"scheme": "MyApp",
"warn": true
}
}list_tests
List all tests for an Xcode scheme.
Parameters:
scheme(required): The Xcode scheme to list tests for
Example:
{
"name": "list_tests",
"arguments": {
"scheme": "MyApp"
}
}build_tests
Build tests for an Xcode scheme.
Parameters:
scheme(required): The Xcode scheme to build tests for
Example:
{
"name": "build_tests",
"arguments": {
"scheme": "MyApp"
}
}run_tests
Run tests for an Xcode scheme.
Parameters:
scheme(required): The Xcode scheme to run tests foronly(optional): Run only specific test
Example:
{
"name": "run_tests",
"arguments": {
"scheme": "MyApp",
"only": "MyAppTests/testExample"
}
}list_packages
List all packages in the Xcode project.
Parameters: None
Example:
{
"name": "list_packages",
"arguments": {}
}Requirements
Node.js 18+
Xcode command line tools
The
xcodebuildcommand must be available in PATH
Development
Project Structure
xcodebuild-mini-mcp/
├── src/
│ ├── index.ts # Main MCP server implementation (following MCP guide patterns)
│ └── xcodebuild.ts # TypeScript implementation of Xcode build operations
├── dist/ # Compiled JavaScript output
├── package.json # Node.js dependencies
├── tsconfig.json # TypeScript configuration
└── README.md # This fileImplementation Details
This server follows the official MCP Node.js guide patterns:
Server Initialization: Uses the recommended
Serverclass from@modelcontextprotocol/sdkTransport: Uses
StdioServerTransportfor stdio-based communicationTool Handlers: Implements
ListToolsRequestSchemaandCallToolRequestSchemahandlersError Handling: Proper error handling with structured responses
Logging: Uses
console.errorfor logging (stdout is reserved for JSON-RPC messages)
Building
npm run buildDevelopment Mode
npm run devError Handling
The MCP server handles errors gracefully and returns structured error responses. Common error scenarios include:
Invalid scheme names
Build failures
Test execution failures
Missing dependencies
All errors are returned with descriptive messages and proper error flags.
License
MIT
Available Tools
4 toolsbuildA
Build the project, not including test targets
Inputs: scheme (required), src, warn.
build_testsB
Build the project, including test targets
Inputs: scheme (required), src, warn.
list_testsC
List all tests for the project
Inputs: scheme (required), src.
run_testsC
Runs the project's tests
Inputs: scheme (required), src, only, coverage.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 4 tools
Each tool serves a unique purpose: build (without tests), build_tests (with tests), list_tests (list test targets), and run_tests (execute tests). No overlap in functionality.
All tool names follow a consistent verb_noun pattern: build, build_tests, list_tests, run_tests. The naming is predictable and uniform.
Four tools cover the essential build and test workflow without unnecessary bloat. The count is well-scoped for a focused Xcode build server.
The set covers core build and test operations (build with/without tests, list/run tests). Missing cleanup or individual test selection, but minimal for a 'mini' server.
Maintenance
Related MCP Connectors
Build, test and cache insights for Xcode, Gradle and Bazel projects, for coding agents.
Model Context Protocol server for Studex tools, notifications, and profile integrations
Model Context Protocol server for todo.vu task management and time tracking.
A Model Context Protocol (MCP) application for automated GitHub PR analysis and issue management.…
Related MCP Servers
- AlicenseDqualityDmaintenanceA Model Context Protocol server that provides tools for Xcode-related operations, making it easier to work with iOS project management, building, testing, archiving, and deploying apps to both simulators and physical devices.912 npm9MIT
- AlicenseBqualityDmaintenanceProvides programmatic access to Xcode functionality, enabling AI assistants to create, build, test, and manage iOS/macOS projects directly.335MIT
- AlicenseAqualityDmaintenanceEnables AI assistants to manage Xcode projects by listing targets, reading configurations, and triggering builds via the Model Context Protocol. It facilitates natural language interaction with macOS developer tools to streamline iOS app development processes.6129 npmMIT
- AlicenseNot gradedqualityDmaintenanceProvides a standardized interface for interacting with Trello's tools and services through the Model Context Protocol.MIT