Xcode MCP Server

Xcode MCP Server

镜像

概述

Xcode MCP 服务器允许 AI 助手直接构建和测试 Xcode 项目,通过模型上下文协议提供标准化接口。

安装

git clone https://github.com/PolarVista/Xcode-mcp-server.git
cd xcode-mcp-server
npm install
npm run build

要求

  • Node.js 16+
  • Xcode 命令行工具
  • TypeScript
  • 兼容 MCP 的客户端(如 Claude Desktop)

配置与启动

  1. 启动服务器:

    npm run start /path/to/build/logs/directory
    
  2. 在 Claude Desktop 配置:

    {
      "command": "node",
      "args": ["/path/to/the/xcode-mcp-server/build/index.js",
               "/path/to/your/project/folder"],
      "env": {
        "PATH": "/usr/bin:/bin:/usr/local/bin:/usr/sbin:/sbin"
      }
    }
    

核心功能

构建项目

build_project({
  projectPath: "/path/to/Project.xcodeproj",
  scheme: "MyApp",
  configuration: "Debug"
})

运行测试

run_tests({
  projectPath: "/path/to/Project.xcodeproj",
  scheme: "MyAppTests",
  testIdentifier: "LoginTests/testSuccessfulLogin",
  skipTests: ["PerformanceTests/testLargeDataLoad"]
})

日志访问

  • 所有日志存储在 build-logs/ 文件夹中
  • 最新日志可通过 xcode-build://latest-log 访问
  • 支持构建日志、测试报告和代码覆盖率报告

更多详细信息请参考完整文档。