xcrun_find_toolLABSCO SUMMARY
The Xcode command line, without remembering the flags.
The Instruments half is the part worth having. Recording a trace, symbolicating it and exporting it are three invocations nobody keeps in their head, and here they are one conversation.
What it is
A Python MCP server wrapping three Xcode command-line tools: xcodebuild for building, testing and archiving, xcrun for locating and running toolchain tools and resolving SDK paths, and xctrace for Instruments recording and export.
What you get
- A project or workspace built, tested, or archived
- Schemes, targets and configurations listed
- Available SDKs and build destinations listed
- A toolchain tool located by name, or run
- An SDK's path and version resolved
- An Instruments trace recorded, imported, exported, or symbolicated
- Errors returned with detailed messages rather than raw exit codes
Requirements
macOS with Xcode and its Command Line Tools installed, plus Python 3.13 or newer. Running it with uvx needs no local install at all.
Setup effort
One command — uvx xctools-mcp-server
USE CASES
01
Running the test suite without leaving the editor
Kick off the tests against a chosen scheme and destination and read the result back.
02
Finding out what you can actually build for
List the project's schemes, then the destinations and SDKs available on this machine.
03
Producing a build for distribution
Archive the scheme rather than building it, so the output is ready to submit.
04
Profiling a screen that feels slow
Record an Instruments trace and symbolicate it so the frames carry names instead of addresses.
05
Reading a trace someone else captured
Import the trace and export what you need out of it, without opening Instruments.
06
Checking which SDK a build will actually pick up
Resolve the SDK path and version in place, before you spend a build finding out.
15 tools
Listed in project docs. Your client may show a different list.
xcrun_show_sdk_pathxcrun_show_sdk_versionxcrun_run_toolxcodebuild_buildxcodebuild_testxcodebuild_archivexcodebuild_listxcodebuild_show_sdksxcodebuild_show_destinationsxctrace_recordxctrace_importxctrace_exportxctrace_listxctrace_symbolicateBEFORE YOU INSTALL
What to know first
Tools you get
15 tools named in the project's documentation.
Requires
- uvx on PATH
- Python 3.13+
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
uvx xctools-mcp-serverMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"xctools": {
"command": "uvx",
"args": [
"xctools-mcp-server"
],
"env": {}
}
}
}VS Code
VS CODE · JSON
{
"servers": {
"xctools": {
"command": "uvx",
"args": [
"xctools-mcp-server"
],
"env": {}
}
}
}
