- Xcode Instruments CLI
Xcode Instruments CLI
What is XCTools MCP Server?
XCTools MCP Server is a Model Context Protocol (MCP) server that provides structured access to Xcode development tools including xcrun, xcodebuild, and xctrace.
How to use XCTools MCP Server?
To use XCTools MCP Server, you can install it using various methods such as uvx, local development installation, or building from source. After installation, you can run the server and configure it for use with various clients like Claude Desktop or VS Code.
Key features of XCTools MCP Server?
- Complete access to Xcode toolchain through
xcrun - Project building and testing capabilities with
xcodebuild - Performance analysis using
xctrace(Instruments) - Comprehensive error handling with detailed messages
- Cross-platform compatibility (macOS with Xcode installed)
Use cases of XCTools MCP Server?
- Finding paths to development tools like clang and swift.
- Building Xcode projects or workspaces.
- Running tests for projects/workspaces.
- Recording performance traces using Instruments.
- Managing SDKs and build destinations.
FAQ from XCTools MCP Server?
- What are the prerequisites for using XCTools MCP Server?
You need Python 3.13+, Xcode with Command Line Tools installed, and optionally
uvxfor easier execution.
- Can I use XCTools MCP Server on non-macOS systems?
No, XCTools MCP Server is designed specifically for macOS with Xcode installed.
- How do I troubleshoot common issues?
Common issues include missing Xcode Command Line Tools, permission errors, and tool not found errors. Ensure Xcode is properly installed and configured.
Server Config
{
"mcpServers": {
"xcinstruments": {
"command": "uvx",
"args": [
"xctools-mcp-server"
],
"env": {}
}
}
}