xcode-mcp

关键词

Xcode 自动化Mac 开发工具工作流工具资源访问构建与测试

使用说明（Markdown 格式）

  1. 项目简介
  • 该仓库实现了一个完整的 MCP 服务器，用 Node.js/TypeScript 编写，基于 @modelcontextprotocol/sdk 的服务端实现模型。服务器通过标准的 MCP 请求/响应机制，向 LLM 客户端提供对“资源、工具、提示模板”等的统一访问接口，支持通过标准传输（此处为 Stdio）与客户端通信。
  1. 主要功能点
  • 内置资源与资源提供：对 Xcode 相关资源（如项目、SDK、证书、描述文件、模拟器等）提供读取与查询能力。
  • 工具集合：提供大量与 Xcode/Apple 生态相关的工具集合，例如创建项目、构建、打包、部署、测试、CI/CD、代码签名、Pods/SPM 依赖管理、资产管理等。
  • 提示模板：包含工作流程相关的 Prompt 模板，帮助 LLM 进行工作流驱动的交互。
  • MCP 服务端能力声明：通过 MCP SDK 的 Server 实例暴露工具、资源、Prompts 的能力集合，支持多传输协议（本实现以 Stdio 为传输）。
  • 会话与错误处理：对未捕获的异常进行兜底处理，提供稳定运行环境。
  • 开发友好：提供开发文档入口、开发工具链命令（如 npm run build、npm run dev）以及插件化扩展结构，便于扩展新的 Tools、Resources、Prompts。
  1. 安装与运行（简要要点）
  • 依赖安装与构建：在仓库根目录执行 npm install；然后执行 npm run build 进行 TypeScript 编译，最终得到可运行的 index.js。
  • 启动方式（开发阶段最常用）：node build/index.js（或按开发脚本执行 npm run dev）启动 MCP 服务器。
  • 运行环境要求：需要运行 macOS（用于 Xcode 相关工具的调用），以及 Node.js 18+。
  • 运行结果：服务器以 Stdio 传输对外提供 JSON-RPC 风格的 MCP 服务，客户端通过配置连接到该服务器的命令与参数即可交互。
  1. 服务器配置（MCP 客户端配置示例） 说明：MCP 客户端需要提供一个配置，指向 MCP 服务器的启动方法与连接信息。以下信息说明均来自仓库信息，且不需要客户端额外的实现细节。
  • server 名称（name）: @coolblack/xcode-mcp
  • 启动命令（command）: node
  • 启动参数（args）: /path/to/xcode-mcp/build/index.js
  • 传输类型（transport）: stdio
  • 备注：MCP 客户端通过此配置与服务器建立连接，随后可以通过 MCP 的标准调用工具、读取资源、执行提示等功能。

示例（文本描述，不以代码块形式呈现）： { "name": "@coolblack/xcode-mcp", "command": "node", "args": ["/path/to/your/project/xcode-mcp/build/index.js"], "transport": "stdio" } 说明：

  • 将 /path/to/your/project 替换为实际的工作目录路径，确保 build/index.js 路径存在。
  • MCP 客户端仅需要读取以上字段来建立与 MCP 服务器的连接；无需将此 JSON 直接嵌入到服务端源码中。
  1. 基本使用方法
  • 启动后，客户端可以通过 MCP 提供的接口：
    • 列出可用工具/资源/提示模板
    • 调用具体工具，传入参数后获得结构化的 ToolResult（含执行时长、输出等）
    • 读取资源内容、查看/修改工作流提示等
  • 运行时遇到错误，服务器会输出日志，帮助定位问题。

关键词 Xcode 自动化, Mac 开发工具, 资源与工具服务, 容器化工作流, Apple 生态自动化

分类ID 1

服务器信息

访问项目