axiom-xcode-mcp

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Xcode MCP Router

You MUST use this skill for ANY Xcode MCP interaction — setup, tool usage, workflow patterns, or troubleshooting.

Xcode 26.3 ships an MCP server (

xcrun mcpbridge

) that exposes 20 IDE tools to external AI clients. This router directs you to the right specialized skill.

任何Xcode MCP交互操作（设置、工具使用、工作流模式或故障排查）都必须使用此技能。

Xcode 26.3 附带了一个MCP服务器（

xcrun mcpbridge

），可向外部AI客户端开放20个IDE工具。本路由工具将引导你使用对应的专业技能。

When to Use

使用场景

Use this router when:

Setting up Xcode MCP for the first time
Configuring
```
xcrun mcpbridge
```
for any MCP client
Using any Xcode MCP tool (file ops, build, test, preview)
Building, testing, or previewing via MCP tools
Troubleshooting mcpbridge connection issues
Window/tab targeting questions
Permission dialog confusion

使用本路由工具的场景：

首次设置Xcode MCP
为任意MCP客户端配置
```
xcrun mcpbridge
```
使用任何Xcode MCP工具（文件操作、构建、测试、预览）
通过MCP工具进行构建、测试或预览
排查mcpbridge连接问题
窗口/标签页定位相关问题
权限对话框相关困惑

Routing Logic

路由逻辑

1. Setup/Connection → xcode-mcp-setup

1. 设置/连接 → xcode-mcp-setup

Triggers:

First-time Xcode MCP setup
Client-specific config (Claude Code, Cursor, Codex, VS Code, Gemini CLI)
Connection errors ("Connection refused", "No windows")
Permission dialog confusion
Multi-Xcode targeting (
```
MCP_XCODE_PID
```
)
Schema compliance issues with strict clients

Invoke:

/skill axiom-xcode-mcp-setup

触发场景:

首次设置Xcode MCP
客户端专属配置（Claude Code、Cursor、Codex、VS Code、Gemini CLI）
连接错误（"Connection refused"、"No windows"）
权限对话框相关困惑
多Xcode实例定位（
```
MCP_XCODE_PID
```
）
严格模式客户端的Schema合规性问题

调用命令:

/skill axiom-xcode-mcp-setup

2. Using Tools & Workflows → xcode-mcp-tools

2. 工具使用与工作流 → xcode-mcp-tools

Triggers:

How to build/test/preview via MCP
Workflow patterns (BuildFix loop, TestFix loop)
Tool gotchas and anti-patterns
Window/tab targeting strategy
When to use MCP tools vs CLI (
```
xcodebuild
```
)
Destructive operation safety (
```
XcodeRM
```
,
```
XcodeMV
```
)

Invoke:

/skill axiom-xcode-mcp-tools

触发场景:

如何通过MCP进行构建/测试/预览
工作流模式（BuildFix循环、TestFix循环）
工具使用陷阱与反模式
窗口/标签页定位策略
MCP工具与CLI（
```
xcodebuild
```
）的使用场景对比
破坏性操作安全（
```
XcodeRM
```
、
```
XcodeMV
```
）

调用命令:

/skill axiom-xcode-mcp-tools

3. Tool API Reference → xcode-mcp-ref

3. 工具API参考 → xcode-mcp-ref

Triggers:

Specific tool parameters and schemas
Input/output format for a tool
"How does XcodeGrep work?"
"What params does BuildProject take?"
Tool category listing

Invoke:

/skill axiom-xcode-mcp-ref

触发场景:

特定工具的参数与Schema
工具的输入/输出格式
"XcodeGrep如何工作？"
"BuildProject需要哪些参数？"
工具分类列表

调用命令:

/skill axiom-xcode-mcp-ref

Decision Tree

决策树

dot

digraph xcode_mcp_router {
    rankdir=TB;
    "User has Xcode MCP question" [shape=ellipse];
    "Setup or connection?" [shape=diamond];
    "Using tools or workflows?" [shape=diamond];
    "Need specific tool params?" [shape=diamond];

    "xcode-mcp-setup" [shape=box];
    "xcode-mcp-tools" [shape=box];
    "xcode-mcp-ref" [shape=box];

    "User has Xcode MCP question" -> "Setup or connection?";
    "Setup or connection?" -> "xcode-mcp-setup" [label="yes"];
    "Setup or connection?" -> "Using tools or workflows?" [label="no"];
    "Using tools or workflows?" -> "xcode-mcp-tools" [label="yes"];
    "Using tools or workflows?" -> "Need specific tool params?" [label="no"];
    "Need specific tool params?" -> "xcode-mcp-ref" [label="yes"];
    "Need specific tool params?" -> "xcode-mcp-tools" [label="general question"];
}

dot

digraph xcode_mcp_router {
    rankdir=TB;
    "User has Xcode MCP question" [shape=ellipse];
    "Setup or connection?" [shape=diamond];
    "Using tools or workflows?" [shape=diamond];
    "Need specific tool params?" [shape=diamond];

    "xcode-mcp-setup" [shape=box];
    "xcode-mcp-tools" [shape=box];
    "xcode-mcp-ref" [shape=box];

    "User has Xcode MCP question" -> "Setup or connection?";
    "Setup or connection?" -> "xcode-mcp-setup" [label="yes"];
    "Setup or connection?" -> "Using tools or workflows?" [label="no"];
    "Using tools or workflows?" -> "xcode-mcp-tools" [label="yes"];
    "Using tools or workflows?" -> "Need specific tool params?" [label="no"];
    "Need specific tool params?" -> "xcode-mcp-ref" [label="yes"];
    "Need specific tool params?" -> "xcode-mcp-tools" [label="general question"];
}

Anti-Rationalization

常见误区纠正

Thought	Reality
"I'll just use xcodebuild directly"	MCP gives IDE state, diagnostics, previews, and navigator issues that CLI doesn't expose
"I already know how to set up MCP"	Client configs differ. Permission dialog behavior is specific. Check setup skill.
"I can figure out the tool params"	Tool schemas have required fields and gotchas. Check ref skill.
"Tab identifiers are obvious"	Most tools fail silently without correct tabIdentifier. Tools skill explains targeting.
"This is just file reading, I'll use Read tool"	XcodeRead sees Xcode's project view including generated files and resolved packages

错误想法	实际情况
"我直接用xcodebuild就行"	MCP能提供CLI无法获取的IDE状态、诊断信息、预览内容和导航器问题
"我已经知道怎么设置MCP了"	不同客户端的配置存在差异，权限对话框的行为也有特殊性，请查看设置类技能
"我自己能搞清楚工具参数"	工具Schema有必填字段和使用陷阱，请查看参考类技能
"标签页标识符很明显"	大多数工具如果没有正确的tabIdentifier会静默失败，工具类技能会解释定位方法
"这只是读取文件，我用Read工具就行"	XcodeRead能查看Xcode的项目视图，包括生成文件和已解析的包

Conflict Resolution (vs Other Routers)

与其他路由工具的冲突解决

Domain	Owner	Why
MCP-specific interaction (mcpbridge, MCP tools, tab identifiers)	xcode-mcp	MCP protocol and tool-specific
Xcode environment (Derived Data, zombie processes, simulators)	ios-build	Environment diagnostics, not MCP
Apple's bundled documentation (for-LLM guides/diagnostics)	apple-docs	Bundled docs, not MCP tool
`DocumentationSearch` MCP tool usage specifically	xcode-mcp	MCP tool invocation
Build failures diagnosed via CLI	ios-build	Traditional build debugging
Build failures diagnosed via MCP tools	xcode-mcp	MCP workflow patterns

领域	负责路由工具	原因
MCP专属交互（mcpbridge、MCP工具、标签页标识符）	xcode-mcp	属于MCP协议和工具专属内容
Xcode环境（Derived Data、僵尸进程、模拟器）	ios-build	属于环境诊断，与MCP无关
Apple官方捆绑文档（面向LLM的指南/诊断内容）	apple-docs	属于捆绑文档，非MCP工具内容
专属 `DocumentationSearch` MCP工具的使用	xcode-mcp	属于MCP工具调用范畴
通过CLI排查的构建失败问题	ios-build	属于传统构建调试
通过MCP工具排查的构建失败问题	xcode-mcp	属于MCP工作流模式范畴

Example Invocations

调用示例

User: "How do I set up Xcode MCP with Claude Code?" -> Invoke:

/skill axiom-xcode-mcp-setup

User: "How do I build my project using MCP tools?" -> Invoke:

/skill axiom-xcode-mcp-tools

User: "What parameters does BuildProject take?" -> Invoke:

/skill axiom-xcode-mcp-ref

User: "My mcpbridge connection keeps failing" -> Invoke:

/skill axiom-xcode-mcp-setup

User: "How do I target a specific Xcode window?" -> Invoke:

/skill axiom-xcode-mcp-tools

User: "Can I render SwiftUI previews via MCP?" -> Invoke:

/skill axiom-xcode-mcp-tools

(workflow), then

/skill axiom-xcode-mcp-ref

(params)

User: "Cursor can't parse Xcode's MCP responses" -> Invoke:

/skill axiom-xcode-mcp-setup

(schema compliance section)

用户："如何在Claude Code中设置Xcode MCP？" -> 调用命令:

/skill axiom-xcode-mcp-setup

用户："如何使用MCP工具构建我的项目？" -> 调用命令:

/skill axiom-xcode-mcp-tools

用户："BuildProject需要哪些参数？" -> 调用命令:

/skill axiom-xcode-mcp-ref

用户："我的mcpbridge连接一直失败" -> 调用命令:

/skill axiom-xcode-mcp-setup

用户："如何定位特定的Xcode窗口？" -> 调用命令:

/skill axiom-xcode-mcp-tools

用户："我能通过MCP渲染SwiftUI预览吗？" -> 调用命令:

/skill axiom-xcode-mcp-tools

（工作流），然后调用

/skill axiom-xcode-mcp-ref

（参数）

用户："Cursor无法解析Xcode的MCP响应" -> 调用命令:

/skill axiom-xcode-mcp-setup

（Schema合规性章节）

axiom-xcode-mcp

Original

Translation

Xcode MCP Router

Xcode MCP Router

When to Use

使用场景

Routing Logic

路由逻辑

1. Setup/Connection → xcode-mcp-setup

1. 设置/连接 → xcode-mcp-setup

2. Using Tools & Workflows → xcode-mcp-tools

2. 工具使用与工作流 → xcode-mcp-tools

3. Tool API Reference → xcode-mcp-ref

3. 工具API参考 → xcode-mcp-ref

Decision Tree

决策树

Anti-Rationalization

常见误区纠正

Conflict Resolution (vs Other Routers)

与其他路由工具的冲突解决

Example Invocations

调用示例

Resources

相关资源