Loading...
An MCP server providing AI access to Xcode projects, simulators, and build tools, enabling automation of iOS development tasks with file system access.
Boost this tool
Subscribe to listing upgrades or segmented pushes.
An MCP server providing AI access to Xcode projects, simulators, and build tools, enabling automation of iOS development tasks with file system access.
This server provides powerful Xcode integration but requires careful configuration to mitigate risks. It is safe when used with trusted AI assistants and well-defined project directories. It becomes risky when exposed to untrusted agents or when handling sensitive data without proper access controls.
Performance depends on the size of the Xcode project and the complexity of the operations. File operations and builds can be time-consuming.
Cost is primarily related to the resources consumed by Xcode builds, simulator usage, and file operations. There are no direct API costs.
npx tsc{
"mcpServers": {
"xcode": {
"command": "node",
"args": ["/path/to/xcode-mcp-server/dist/index.js"]
}
}
}PROJECTS_BASE_DIRDEBUGALLOWED_PATHSPORTcreate_xcode_projectCreates a new Xcode project from a template.
Creates new files and directories, modifying the file system.
add_swift_packageAdds a Swift Package dependency to the project.
Modifies the project configuration by adding a dependency.
read_fileReads the content of a file.
Read-only operation, no side effects.
write_fileWrites content to a file, creating it if it doesn't exist.
Modifies the file system by writing to files.
search_in_filesSearches for text content within files using patterns and regex.
Read-only operation, no side effects.
build_projectBuilds the Xcode project with specified scheme and configuration.
Executes build commands that can modify the file system.
test_projectRuns tests for the Xcode project with detailed failure reporting.
Executes test commands that can modify the file system.
list_simulatorsLists available iOS simulators with detailed information.
Read-only operation, no side effects.
boot_simulatorBoots a specified iOS simulator.
Starts a simulator, potentially consuming system resources.
shutdown_simulatorShuts down a specified iOS simulator.
Stops a simulator, potentially disrupting ongoing processes.
install_app_on_simulatorInstalls an application on a specified iOS simulator.
Installs an app, modifying the simulator's state.
xcrunExecutes Xcode commands via xcrun.
Can execute arbitrary Xcode commands, potentially leading to system modifications.
Environment Variable
cloud
This server provides powerful Xcode integration but requires careful configuration to mitigate risks. It is safe when used with trusted AI assistants and well-defined project directories. It becomes risky when exposed to untrusted agents or when handling sensitive data without proper access controls.
Autonomy depends on the configured permissions and the AI assistant's decision-making process. Exercise caution when granting full access.
Production Tip
Carefully validate all input paths and commands to prevent unauthorized file access or execution.
Xcode 14.0 or higher is required.
Set the `PROJECTS_BASE_DIR` environment variable to the directory containing your Xcode projects.
No, but it's recommended to restrict access to trusted AI assistants and secure the server environment.
Yes, the server includes instructions for configuring it with Claude Desktop.
Set the `DEBUG` environment variable to `true`.
The server supports different encodings, including UTF-8.
Use the `ALLOWED_PATHS` environment variable, separating paths with commas.