Araç yanıtlarını onararak ve paylaşılan bağlantılar için bir broker modu sunarak harici MCP istemcilerini Xcode'a bağlar.
Ayrıca bilinen adı SoundBlaster/XcodeMCPWrapper, xcode-mcpbridge-wrapper, mcpbridge-wrapper
- Yıldızlar
- 20
- Araçlar
- —
- İndirmeler, 30 gün
- 344
- En son sürüm
- 0.5.0
- Son commit
- 25 Eyl 2026
- Lisans
- MIT
Xcode MCP Bridge Wrapper MCP nedir?
Araç yanıtlarını onararak ve paylaşılan bağlantılar için bir broker modu sunarak harici MCP istemcilerini Xcode'a bağlar.
Özet, projenin README dosyasından oluşturuldu
Xcode MCP Bridge Wrapper MCP sunucusu hakkında
Bu köprü wrapper, macOS geliştiricileri için harici yapay zeka ajanlarını Xcode geliştirme araçlarına bağlamayı sağlar. Apple'ın xcrun mcpbridge yapısı ile Cursor, Zed, Codex veya Claude Code gibi MCP istemcileri arasında bir ara katman görevi görür. Çıktı şeması beyan edilmesine rağmen yapılandırılmış içerikten yoksun olan araç yanıtlarını onararak, yapay zeka istemcilerinin Xcode'dan dönen verileri doğru şekilde yorumlamasını sağlar.
Kullanıcılar, tekli bağlantılar için doğrudan mod veya tek bir kalıcı Xcode bağlantısını birden fazla istemci arasında paylaşmak için broker modu arasında seçim yapabilirler. Bu broker yaklaşımı, bağlantı istemlerinin sıklığını azaltır. Sunucu kurulumu için Xcode 26.3 veya daha yeni bir sürüm, Python 3.9 ile 3.12 arası bir sürüm ve uv paket yöneticisi gereklidir. Araçları kendisi paketlemez, bunun yerine yüklü Xcode sürümünüzdeki workspace yönetimi, derleme kontrolleri ve cihaz etkileşim yetenekleri dahil olmak üzere mevcut kataloğu sunar.
Projenin README dosyasından alınmıştır. Her kullanım durumu, oradaki bir alıntı ile kontrol edilir.
Xcode MCP Bridge Wrapper MCP nasıl yüklenir
Biçimler 10 Kas 2026 tarihinde doğrulandıCursor'a ekleGoose'a ekleXcode MCP Bridge Wrapper MCP'yi Claude Code içine yükleyin
$ claude mcp add xcode-mcpbridge-wrapper -- uvx mcpbridge-wrapperXcode MCP Bridge Wrapper MCP'yi Cursor içine yükleyin
~/.cursor/mcp.json
{
"mcpServers": {
"xcode-mcpbridge-wrapper": {
"command": "uvx",
"args": [
"mcpbridge-wrapper"
]
}
}
}Xcode MCP Bridge Wrapper MCP'yi VS Code içine yükleyin
.vscode/mcp.json
{
"servers": {
"xcode-mcpbridge-wrapper": {
"type": "stdio",
"command": "uvx",
"args": [
"mcpbridge-wrapper"
]
}
}
}Xcode MCP Bridge Wrapper MCP'yi VS Code CLI içine yükleyin
$ code --add-mcp '{"name":"xcode-mcpbridge-wrapper","type":"stdio","command":"uvx","args":["mcpbridge-wrapper"]}'Xcode MCP Bridge Wrapper MCP'yi Claude Desktop içine yükleyin
claude_desktop_config.json
{
"mcpServers": {
"xcode-mcpbridge-wrapper": {
"command": "uvx",
"args": [
"mcpbridge-wrapper"
]
}
}
}Xcode MCP Bridge Wrapper MCP'yi Codex içine yükleyin
$ codex mcp add xcode-mcpbridge-wrapper -- uvx mcpbridge-wrapperXcode MCP Bridge Wrapper MCP'yi Codex config.toml içine yükleyin
~/.codex/config.toml
[mcp_servers.xcode-mcpbridge-wrapper] command = "uvx" args = ["mcpbridge-wrapper"]
Xcode MCP Bridge Wrapper MCP'yi Gemini CLI içine yükleyin
$ gemini mcp add -s user xcode-mcpbridge-wrapper uvx -- mcpbridge-wrapperXcode MCP Bridge Wrapper MCP'yi Gemini settings.json içine yükleyin
~/.gemini/settings.json
{
"mcpServers": {
"xcode-mcpbridge-wrapper": {
"command": "uvx",
"args": [
"mcpbridge-wrapper"
]
}
}
}Otomatik kontroller
Çalıştırıldı 14 Kas 2026Tam rapor →Otomatik kontrollerimizden geçti. Bu bir güvenlik denetimi değildir: kodu okuyun ve sunucuya ihtiyaç duyduğu en dar erişimi verin. Kontroller nasıl çalışır
- Kaynak deposu bağlantılı ve erişilebilirsoundblaster/xcodemcpwrapper is public and reachablegithub.com/soundblaster/xcodemcpwrapper ↗Geçti
- Paket, bu depoyu kaynağı olarak gösteriyormcpbridge-wrapper names soundblaster/xcodemcpwrapper as sourcepypi.org/project/mcpbridge-wrapper/ ↗Geçti
- Derleme kökeni (Sigstore onayı)Sigstore attestation for mcpbridge-wrapperpypi.org/project/mcpbridge-wrapper/ ↗Geçti
- Açık kaynak lisansı (OSI)MITspdx.org/licenses/MIT.html ↗Geçti
- Son bir yıl içinde commit veya sürüm mevcutLast commit or release 2026-09-25github.com/soundblaster/xcodemcpwrapper ↗Geçti
- OpenSSF ScorecardKontrol edilmedi
- Paket adı popüler bir pakete yakın değilNo popular package one edit away from mcpbridge-wrapperGeçti
- Pakette veya bağımlılıklarında kritik uyarı yok6 resolved dependencies checked; no critical advisoryosv.dev ↗Geçti
- Modele yönelik gizli talimat yok0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersGeçti
- Yıkıcı araçlar etiketlenmişKontrol edilmedi
- Uzak uç nokta MCP el sıkışmasına yanıt veriyorKontrol edilmedi
Xcode MCP Bridge Wrapper
mcpbridge-wrapper connects external MCP clients to Xcode through Apple's
xcrun mcpbridge. It repairs Xcode tool responses that declare an
outputSchema but omit structuredContent. The repair works in both direct
and broker modes. Broker mode also lets several clients share one persistent
Xcode connection, reducing repeated connection prompts.
Compatibility
| Component | Support in 0.5.0 |
|---|---|
| Xcode | 26.3+ and 27.0 on macOS; Xcode 27.0 handshake and tool discovery verified |
| MCP clients | Clients using the initialize lifecycle; check the protocol used by your client version |
| MCP 2026-07-28 | Not supported by 0.5.0; the sessionless implementation remains experimental on a separate branch |
| Python | 3.9-3.12; uvx manages its own environment |
The wrapper does not bundle Xcode tools. It exposes the catalog returned by
the installed Xcode, so tool names and availability can change with Xcode
updates and permissions. The Xcode 27.0 catalog observed with build 27A266a
is listed below.
Quick Start
- Install uv and Xcode 26.3 or newer. Xcode 27.0 is supported.
- In Xcode > Settings > Intelligence > Model Context Protocol, enable Allow external agents to use Xcode tools. Open the project you want to use in Xcode. See Apple's setup guide.
- Add one of the client configurations below. Pin
0.5.0to keep the legacy MCP contract when a future major release becomes available. - Start the client and approve the Xcode access prompt if shown. After
approval, reload or reconnect the MCP server in the client so it fetches
tools/listagain, then verify with a real Xcode tool call. A green MCP indicator alone only confirms the handshake.
Broker mode is recommended for multiple clients. All examples use the same per-user daemon. The first client starts it; subsequent clients reuse it.
Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"xcode-tools": {
"command": "uvx",
"args": ["--from", "mcpbridge-wrapper==0.5.0", "mcpbridge-wrapper", "--broker"]
}
}
}
Codex
Add to ~/.codex/config.toml and restart Codex:
[mcp_servers.xcode-tools]
command = "uvx"
args = ["--from", "mcpbridge-wrapper==0.5.0", "mcpbridge-wrapper", "--broker"]
Zed
Add inside ~/.config/zed/settings.json under the top-level
context_servers key, then disable and re-enable the server in
Settings > AI > MCP Servers:
{
"context_servers": {
"xcode-tools": {
"command": "uvx",
"args": ["--from", "mcpbridge-wrapper==0.5.0", "mcpbridge-wrapper", "--broker"],
"env": {}
}
}
}
See Zed's MCP configuration guide for the settings UI and server status indicator.
Claude Code
claude mcp add --transport stdio xcode -- uvx --from 'mcpbridge-wrapper==0.5.0' mcpbridge-wrapper --broker
For a single client that does not need the shared daemon, remove --broker
from its command to use direct mode. Manual installation and Web UI options
are covered in the installation,
broker, and Web UI guides.
Xcode 27.0 Approval and Verification
Xcode 27.0 may ask for permission for the broker host process and for the
project folder. The prompt identifies the Python executable and PID, not the
editor name. A new uvx host identity may need a fresh approval even if an
older Python installation was already permitted. Approve access only when the
path and project are expected.
If a tool reports that the agent is not approved, use XcodeOpenWorkspace
with the absolute path of an existing .xcodeproj or .xcworkspace to
request access, approve the prompt in Xcode, then retry the read-only tool.
Do not treat a successful tools/list or a green client status dot as proof
that Xcode tool calls are authorized. Check Xcode's state with:
xcrun mcp-server status
uvx --from 'mcpbridge-wrapper==0.5.0' mcpbridge-wrapper --broker-status
The second command should show Proxy version: 0.5.0 and Daemon version: 0.5.0. If an older daemon is still running, stop it once and reconnect the
clients:
uvx --from 'mcpbridge-wrapper==0.5.0' mcpbridge-wrapper --broker-stop
Stopping the singleton temporarily disconnects every client using it. The
next --broker connection starts a new daemon. For a stable long-lived host
identity, see the dedicated broker host.
Xcode 27.0 Tools
tools/list exposed 54 tools on Xcode 27.0 build 27A266a during a
local smoke test. This is an observed catalog, not a hard-coded wrapper API.
Xcode 27 adds workspace creation/opening, simulator interaction, run and
debugger control, build configuration, localization, and crash/field insight
tools. See Apple's Xcode 27 release notes.
- Workspaces and targets:
XcodeListWorkspaces,XcodeOpenWorkspace,XcodeCloseWorkspace,XcodeNewProject,XcodeNewTarget,XcodeListTargets,XcodeListTemplates,XcodeListSchemes,XcodeSwitchScheme,XcodeListRunDestinations,XcodeSwitchRunDestination,XcodeListTestPlans,XcodeSwitchTestPlan. - Files and diagnostics:
XcodeRead,XcodeWrite,XcodeUpdate,XcodeLS,XcodeGlob,XcodeGrep,XcodeMakeDir,XcodeMV,XcodeRM,XcodeRefreshCodeIssuesInFile. - Build, test, run, and debug:
BuildProject,GetBuildLog,GetTestList,RunAllTests,RunSomeTests,RunProject,StopProject,GetConsoleOutput,InvokeDebuggerCommand,GetFileCompilerFlags,UpdateFileCompilerFlags,GetTargetBuildSettings,UpdateTargetBuildSetting. - Device interaction:
DeviceInteractionStartSession,DeviceInteractionStartWorkspaceSession,DeviceInteractionInstallAndRun,DeviceInteractionSynthesize,DeviceInteractionEndSession. - Localization:
LocalizationPlanner,StringCatalogContext,StringCatalogRead,StringCatalogEdit. - Crash and field insights:
GetTopCrashIssues,GetCrashIssueLogs,GetTopFieldPerformanceIssues,GetFieldPerformanceIssueLogs. - Previews and reference:
RenderPreview,DocumentationSearch,RunCodeSnippet. - Project metadata:
AddEntitlement,AddInfoPlist.
In this catalog, the older XcodeListWindows name is absent; use
XcodeListWorkspaces to inspect workspaces after Xcode approval. Tool calls
such as builds, file edits, and device interaction can change project or
device state. Start with read-only calls when validating a new setup.
Development
For source installation and quality gates, see Contributing. The package is also available on PyPI and in the MCP Registry.
Licensed under the MIT License.
Xcode MCP Bridge Wrapper MCP soruları
Xcode MCP Bridge Wrapper MCP'yi Claude Code'a nasıl eklerim?
Terminalinizde claude mcp add xcode-mcpbridge-wrapper -- uvx mcpbridge-wrapper komutunu çalıştırın. Her projede kullanılabilir olması için --scope user ekleyin.
Xcode MCP Bridge Wrapper MCP'yi Cursor'a nasıl eklerim?
~/.cursor/mcp.json dosyasını açın ve yukarıdaki yükleme bölümünde gösterilen Cursor yapılandırmasını kullanarak sunucuyu mcpServers altına ekleyin.
Broker modu nedir?
Broker modu, birden fazla istemcinin tek bir kalıcı Xcode bağlantısını paylaşmasına olanak tanıyarak tekrarlanan bağlantı istemlerinin sayısını azaltır.
Bu wrapper Xcode araçlarını içeriyor mu?
Hayır, wrapper Xcode araçlarını paketlemez; yüklü Xcode sürümünüz tarafından döndürülen kataloğu sunar.
Xcode araçlarımın gerçekten yetkilendirilip yetkilendirilmediğini nasıl doğrulayabilirim?
Sadece yeşil durum göstergesine güvenmeyin; bunun yerine durumu xcrun mcp-server status veya wrapper'ın broker-status komutunu kullanarak kontrol edin.