https://github.com/everettjf/MCPXcode
MCP server for Xcode
https://github.com/everettjf/MCPXcode
Last synced: 2 months ago
JSON representation
MCP server for Xcode
- Host: GitHub
- URL: https://github.com/everettjf/MCPXcode
- Owner: everettjf
- License: mit
- Created: 2025-03-21T23:28:51.000Z (8 months ago)
- Default Branch: main
- Last Pushed: 2025-03-22T05:13:51.000Z (8 months ago)
- Last Synced: 2025-03-22T05:25:28.218Z (8 months ago)
- Language: Python
- Size: 14.6 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - **MCPXcode** - MCP server for Xcode `python` `mcp` `server` `pip install git+https://github.com/everettjf/MCPXcode` (🤖 AI/ML)
- awesome-mcp-servers - **MCPXcode** - MCP server for Xcode `python` `mcp` `server` `pip install git+https://github.com/everettjf/MCPXcode` (AI/ML)
README
# MCPXcode
*!!! This Project is in Active Development, So May Have Unexpected Issues*
## Introduction
MCPXcode is an open-source implementation of the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/introduction) for Xcode. It enables seamless integration between Xcode and AI assistants by providing a structured protocol for context exchange and tool execution within the Xcode environment.
Following the MCP specification, this project creates a bridge between Xcode's development environment and AI tools, allowing for enhanced developer workflows through contextual understanding and programmable interactions. It wraps common command-line tools (`xcrun`, `xctrace`) and leverages macOS accessibility features to enable AI-assisted automation of Xcode operations.
## Screenshots
## Installation
```bash
# Install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
# Clone the repository
git clone https://github.com/everettjf/MCPXcode.git
cd MCPXcode
source .venv/bin/activate
uv add "mcp[cli]"
```
## Configuration
```json
{
"mcpServers": {
"MCPXcode": {
"command": "uv", # may use full path
"args": [
"--directory",
"/MCPXcode", # change to your full path
"run",
"main.py"
]
}
}
}
```
## Features
### Current MCP Tool Integrations
- **xcrun Tool Extensions**
- Context-aware interfaces for common xcrun commands
- Structured output formatting for AI consumption
- Semantic error handling and diagnostic reporting
- **xctrace Tool Extensions**
- Context-enhanced profiling and tracing for iOS/macOS applications
- Structured performance metrics collection for AI analysis
- Trace data processing with semantic context
### Planned Extensions
- **Accessibility Tool Extensions**
- Context-aware UI interactions within Xcode
- Semantic triggers for build, run, and test operations
- Structured project navigation capabilities
- Enhanced context extraction from Xcode UI
- **MCP HTTP Server**
- Full MCP specification compliance over HTTP
- Standardized tool execution protocol
- Context-preserving webhooks for build events
- Seamless integration with AI-powered CI/CD pipelines
- **MCP Client Libraries**
- Language-specific SDKs implementing the MCP specification
- Simplified context exchange between AI assistants and Xcode
## Tool Documentation
### Simulator Control Tools
| Tool | Description | Example Prompt |
|------|-------------|----------------|
| `list_devices` | List all available simulator devices with detailed information | "Show me all available iOS simulator devices and their status." |
| `boot_device` | Boot a specific simulator device identified by its UDID | "Boot the iPhone 14 Pro simulator with UDID A1B2C3D4-E5F6-7890-1234-567890ABCDEF." |
| `shutdown_device` | Shutdown a running simulator device | "Shutdown the currently running iPhone simulator with UDID A1B2C3D4-E5F6-7890-1234-567890ABCDEF." |
| `install_app` | Install an application on a simulator device | "Install the app at path /Users/username/MyApp.app on the iPhone 14 simulator." |
| `launch_app` | Launch an installed application on a simulator device | "Launch the app with bundle ID com.example.myapp on the iPhone 14 simulator." |
### SDK Tools
| Tool | Description | Example Prompt |
|------|-------------|----------------|
| `get_sdk_path` | Get the path of the current SDK | "What is the path to the current iOS SDK?" |
| `get_sdk_version` | Get the version of the current SDK | "What version of the iOS SDK am I using?" |
| `get_sdk_platform_path` | Get the platform path of the current SDK | "Where are the iOS platform files located?" |
| `find_developer_tool` | Find the path of a specific developer tool | "Where is the 'lldb' binary located in the Xcode toolchain?" |
| `run_tool_with_sdk` | Run a developer tool with a specific SDK | "Run the 'clang' tool with the iOS SDK to compile my source file." |
### xcrun Tools
| Tool | Description | Example Prompt |
|------|-------------|----------------|
| `xcrun_list_sdks` | List all available SDKs with detailed information | "Show me all available SDKs I can build against." |
| `xcrun_list_schemes` | List all schemes in a specified Xcode project | "What are all the build schemes in my MyApp.xcodeproj project?" |
| `xcrun_build` | Build an Xcode project with specified scheme and configuration | "Build my MyApp.xcodeproj project using the Debug configuration for the iPhone simulator." |
| `xcrun_validate_app` | Validate an app before submission to App Store | "Validate my MyApp.ipa file before submitting it to the App Store." |
| `xcrun_upload_app` | Upload an app to App Store Connect | "Upload my validated MyApp.ipa file to App Store Connect for review." |
| `xcrun_swift_symbols` | Extract Swift symbols from a binary file | "Extract and show me all Swift symbols from my app's binary." |
| `xcrun_otool_headers` | Show Mach-O headers of a binary file | "Show me the Mach-O headers of my app's binary file." |
| `xcrun_otool_libraries` | Show linked libraries of a binary file | "What libraries is my app's binary linked against?" |
| `xcrun_nm_symbols` | Show symbols in a binary file | "Show me all symbols in my app's binary file." |
### xctrace Tools
| Tool | Description | Example Prompt |
|------|-------------|----------------|
| `xctrace_devices` | List available devices for tracing | "Show me all devices I can run performance traces on." |
| `xctrace_templates` | List available templates for tracing | "What trace templates are available for performance profiling?" |
| `xctrace_record` | Record app performance using a specified template | "Record a performance trace of my app using the Time Profiler template." |
| `xctrace_record_advanced` | Record app performance with advanced options | "Record a performance trace with custom template options and set the environment variable DEBUG=1." |
| `xctrace_attach_process` | Attach to a running process for tracing | "Attach a performance tracer to my running app with process ID 12345." |
| `xctrace_export` | Export trace data to a specified format | "Export my trace.trace file to JSON format for analysis." |
| `xctrace_diagnose` | Diagnose a trace archive for issues | "Analyze my trace file for any performance issues or problems." |
| `xctrace_document` | Generate documentation for a template | "Create documentation for the Allocations template so I can understand its metrics." |
| `xctrace_analyze` | Analyze a trace file and generate performance reports | "Generate performance reports from my time profiler trace file." |
| `xctrace_compare` | Compare two trace files and generate a comparison report | "Compare the performance between trace files from version 1.0 and version 2.0 of my app." |
## Project Roadmap
### Phase 1: MCP Core Implementation (Q2 2025)
- ✅ Basic project structure
- ⬜ Tool extensions for essential xcrun commands with context handling
- ⬜ Tool extensions for basic xctrace functionality with context handling
- ⬜ MCP-compliant CLI interface
### Phase 2: MCP Server Implementation (Q3 2025)
- ⬜ Full MCP specification HTTP server
- ⬜ Context-aware authentication and security
- ⬜ Structured context exchange protocol
- ⬜ Extensible tool registry architecture
### Phase 3: MCP Accessibility Extensions (Q4 2025)
- ⬜ macOS accessibility integration with semantic context
- ⬜ Context-aware Xcode UI automation
- ⬜ Semantic event monitoring and contextual reactions
### Phase 4: Advanced MCP Features (Q1 2026)
- ⬜ MCP-compliant Python client library
- ⬜ Context-aware integration with AI-powered CI/CD tools
- ⬜ Semantic context monitoring dashboard
## License
This project is licensed under the MIT License - see the LICENSE file for details.
## Contributing
Contributions are welcome! Please feel free to submit a Pull Request.