You signed in with another tab or window. Reload to refresh your session.You signed out in another tab or window. Reload to refresh your session.You switched accounts on another tab or window. Reload to refresh your session.Dismiss alert
Easiest way to install XcodeBuildMCP is to use Smithery to install it from the registry. Copy and paste one of the following commands into your terminal.
[<imgsrc="https://img.shields.io/badge/VS_Code-VS_Code?style=flat-square&label=Install%20Server&color=0098FF"alt="Install in VS Code">](https://insiders.vscode.dev/redirect/mcp/install?name=XcodeBuildMCP&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22xcodebuildmcp%40latest%22%5D%7D)
127
206
128
207
[<imgalt="Install in VS Code Insiders"src="https://img.shields.io/badge/VS_Code_Insiders-VS_Code_Insiders?style=flat-square&label=Install%20Server&color=24bfa5">](https://insiders.vscode.dev/redirect/mcp/install?name=XcodeBuildMCP&config=%7B%22command%22%3A%22npx%22%2C%22args%22%3A%5B%22-y%22%2C%22xcodebuildmcp%40latest%22%5D%7D&quality=insiders)
129
208
130
-
#### General installation
209
+
#### Manual installation
131
210
132
211
Most MCP clients (Cursor, VS Code, Windsurf, Claude Desktop etc) have standardised on the following JSON configuration format, just add the the following to your client's JSON configuration's `mcpServers` object:
133
212
@@ -174,38 +253,9 @@ claude mcp add XcodeBuildMCP npx xcodebuildmcp@latest
174
253
claude mcp add XcodeBuildMCP npx xcodebuildmcp@latest -e INCREMENTAL_BUILDS_ENABLED=false -e XCODEBUILDMCP_SENTRY_DISABLED=false
175
254
```
176
255
177
-
##### Smithery
178
-
179
-
XcodeBuildMCP runs as a local (stdio) server when installed via [Smithery](https://smithery.ai/server/@cameroncooke/XcodeBuildMCP). You can configure it in the Smithery session UI or via environment variables.
180
-
181
-
```bash
182
-
# Claude Desktop / Claude Code
183
-
npx -y @smithery/cli install @cameroncooke/XcodeBuildMCP --client claude
If your client isn't listed, run `npx smithery install --help` to see supported values for `--client`.
193
-
194
256
> [!IMPORTANT]
195
257
> Please note that XcodeBuildMCP will request xcodebuild to skip macro validation. This is to avoid errors when building projects that use Swift Macros.
196
258
197
-
#### MCP Compatibility
198
-
199
-
XcodeBuildMCP supports both MCP tools, resources and sampling. At time of writing the following editors have varying levels of MCP feature support:
200
-
201
-
| Editor | Tools | Resources | Samplng |
202
-
|--------|-------|-----------|---------|
203
-
|**VS Code**| ✅ | ✅ | ✅ |
204
-
|**Cursor**| ✅ | ❌ | ❌ |
205
-
|**Windsurf**| ✅ | ❌ | ❌ |
206
-
|**Claude Code**| ✅ | ✅ | ❌ |
207
-
|**Claude Desktop**| ✅ | ✅ | ❌ |
208
-
209
259
## Incremental build support
210
260
211
261
XcodeBuildMCP includes experimental support for incremental builds. This feature is disabled by default and can be enabled by setting the `INCREMENTAL_BUILDS_ENABLED` environment variable to `true`:
@@ -350,6 +400,8 @@ See our documentation for development:
350
400
-[TESTING](docs/TESTING.md) - Testing principles and patterns
351
401
-[ARCHITECTURE](docs/ARCHITECTURE.md) - System architecture and design principles
352
402
403
+
</details>
404
+
353
405
## Licence
354
406
355
407
This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.
0 commit comments