Xcode MCP Server

Name: Xcode MCP Server
Author: drewster99

@drewster99

代码仓库

关于 Xcode MCP Server

MCP Server for interacting with Xcode

#xcode #developer #tool

基本信息

分类

其他

许可证

MIT

运行时

python

传输方式

stdio

发布者

drewster99

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "xcode-mcp-server": {
      "command": "uvx",
      "args": [
        "xcode-mcp-server"
      ]
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Xcode MCP Server?

Xcode MCP Server is an MCP (Model Context Protocol) server that enables AI assistants to control and interact with Xcode for Apple platform development. It is built for macOS and requires Xcode and Python 3.10+.

How to use Xcode MCP Server?

Install via uv and configure in your MCP client (Claude Code, Claude Desktop, or Cursor) using the provided JSON commands. Security is managed via the XCODEMCP_ALLOWED_FOLDERS environment variable to restrict which directories the server can access.

Key features of Xcode MCP Server

Discover and navigate Xcode projects and source files
Build and run iOS, macOS, tvOS, and watchOS applications
Execute and monitor tests with detailed results
Debug build failures by retrieving errors and warnings
Capture console output and take screenshots
Manage simulators and view their status

Use cases of Xcode MCP Server

Have an AI assistant find and build your Xcode project
Automate test execution and failure reporting
Troubleshoot build errors without leaving the AI chat
Run and capture simulator or Xcode window screenshots
Manage simulator devices programmatically

FAQ from Xcode MCP Server

What are the system requirements?

macOS is required, along with Xcode and Python 3.10+. The uv package manager is also needed for installation.

How do I restrict which folders the server can access?

Set the XCODEMCP_ALLOWED_FOLDERS environment variable to a colon-separated list of absolute directory paths. If unset, the server defaults to your home directory.

What can the server do for me?

It allows AI assistants to discover projects, build and run apps, execute tests, debug build failures, capture console output and screenshots, and manage simulators.

How do I set it up with Claude Desktop?

Add an entry to ~/Library/Application Support/Claude/claude_desktop_config.json with the command uvx and argument xcode-mcp-server. You can optionally add an env section for folder restrictions.