XcodeBuildMCP

使用说明

• 项目简介
  • XcodeBuildMCP 是一个完整的 MCP 服务器实现，提供资源管理、工具注册与执行、以及提示模板的渲染等能力，供 LLM 客户端通过 MCP 协议进行上下文信息获取和功能调用。它还包含一个命令行界面（CLI）用于本机直接操作与开发测试，以及用于在 macOS/Xcode 上的 Agent 场景的运行支持。
• 主要功能点
  • 资源管理：集中暴露并管理资源（Resources），_llm 客户端可以读取资源内容。
  • 工具注册与执行：实现将 Tools 注册到服务器、通过 MCP 调用外部功能，支持本地执行、通过守护进程路由执行，以及 Xcode IDE 相关的动态工具调用。
  • 提示模板（Prompts）渲染：支持在工具输出中嵌入可配置的提示模板与后续步骤（Next Steps），并支持在不同运行时（CLI/MCP/Daemon）渲染不同格式。
  • 会话与能力声明：包括会话初始化、默认会话、工作流激活等，以及对服务器能力（资源、工具、提示等）的声明。
  • 多传输协议支持：服务器可通过 stdio、SSE、WebSocket 等传输与客户端通信，确保在不同环境下的接入能力。
  • 客户端配置与集成：提供与 MCP 客户端的对接示例、以及通过 Cursor/Claude/Codex 等工具集成的方法。
• 安装步骤
  • 选项 A：通过 Homebrew 安装
    • tap getsentry/xcodebuildmcp
    • brew install xcodebuildmcp
    • 使用 CLI 启动 MCP 服务器：xcodebuildmcp mcp
  • 选项 B：通过 npm/npx 使用
    • 全局安装 CLI：npm install -g xcodebuildmcp@latest
    • 启动 MCP 服务器：xcodebuildmcp mcp
    • 仅作为 MCP 服务器时，可直接在客户端配置中使用 npx 启动：{"XcodeBuildMCP": {"command": "npx", "args": ["-y", "xcodebuildmcp@latest", "mcp"]}}
• 服务器配置（MCP 客户端的连接配置）
  • 服务器名称：XcodeBuildMCP（用于在客户端配置中区分不同 MCP 服务器）
  • 启动命令示例（MCP 客户端配置需要 command 与 args）：为 MCP 客户端提供的最小启动信息应包含服务器名称和启动命令及参数，例如：
    • 名称：XcodeBuildMCP
    • command: npx
    • args: ["-y", "xcodebuildmcp@latest", "mcp"]
  • 说明：以上配置用于 MCP 客户端通过 JSON 配置文件建立与 MCP 服务器的连接，实际使用时请按你所选择的部署方式调整命令与版本。
• 基本使用方法
  • 启动方式
    • 本地开发：通过 CLI 启动 MCP 服务器，随后集成到 MC 客户端进行消息交互。
    • 生产/集成：将服务器作为后台服务部署，客户端通过 MCP 协议与之通信，服务器负责资源、工具与模板的暴露与执行。
  • 客户端交互要点
    • 请求资源读取、调用工具、获取 Prompts 等，服务器统一返回 MCP JSON-RPC 兼容的响应。
    • 服务器会话管理、能力声明以及对不同传输协议的支持，确保 LLM 应用可在多种环境下稳定访问上下文服务。
  • 常用操作
    • 通过官方文档和示例配置，结合你们的落地框架（Claude/Codex 等）按需接入 MCP 服务。