X Code MCP Service

MCP开发工具

提供方 ljh740

开发工具 未标注 Token 社区 / 第三方

XCodeMCPService是一个保持xcrun mcpbridge在后台运行并通过可流式HTTP转发MCP请求的服务,适用于需要避免重复Xcode授权提示的开发场景。

一句话选型结论

按资料字段整理

X Code MCP Service 属于开发工具类 MCP 服务器,传输方式未标注,Token,没有现成安装命令,需按官方文档接入。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类开发工具 传输方式未标注 鉴权Token 部署方式未标注
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 未标注 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

开发工具
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量未标注暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

适用场景

Swift本地部署Xcode工具MCP转发开发效率HTTP服务

安装与配置

未标注 Token
上游未给出传输方式
  1. 1
    准备运行环境

    按官方文档确认运行环境(常见为 Node.js 或 Python),装好后再执行安装命令。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后随便调一个只读工具,确认能返回结果,再接入正式流程。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
代码与仓库操作

在对话里直接查代码、提 issue、走 PR,省掉来回切工具。

本地命令与脚本

把构建、测试、格式化这类重复命令交给模型执行。

接口联调与测试

让模型调你的接口、跑一遍用例,快速定位问题。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 基础信息齐全,可以先按官方文档接入试跑。

先想清楚的地方

  • 没有现成安装命令,需要按官方文档自己填启动命令和参数。
  • 使用前要准备好Token对应的凭据,并按最小权限配置。
  • 资料没标注工具数量,实际能力要装好后确认。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在开发工具场景里让模型直接调用外部能力的人。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
X Code MCP Service当前 未标注 未标注 未标注 无 2026-05-17
Git 838e2ec1 12 stdio · 本地进程 本地部署 有 2026-05-17
Markitdown MCP 2c653a5f 1 stdio · 本地进程 本地部署 有 2026-05-17
JavaGuide 未标注 stdio · 本地进程 本地部署 有 2026-04-11
awesome-claude-skills 未标注 stdio · 本地进程 本地部署 有 2026-04-26
Context7 831acf40 未标注 stdio · 本地进程 本地部署 有 2026-05-17

服务器档案

开发工具
字段来自项目仓库与公开索引,中文说明由本站标注
提供方ljh740上游标注的维护方 ljh740
分类开发工具本站按上游分类展示
连接方式未标注上游未给出传输方式
鉴权方式Token远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · 未标注本地安装时用到的包标识与运行时
部署类型未标注上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

5.2 KB
来自项目仓库与上游目录的原文,未做删改

XCodeMCPService

中文文档

MCP Forward Bridge — Keep xcrun mcpbridge running in the background and forward MCP requests via Streamable HTTP.

Every MCP client connection spawns a new xcrun mcpbridge process, triggering an Xcode authorization prompt. This project keeps a single xcrun mcpbridge process alive and aggregates forwarded requests, eliminating repeated authorization.```
MCP Client ──HTTP/POST──▶ XCodeMCPService ──stdio──▶ MCP Server (xcrun mcpbridge)
◀──JSON-RPC─── ◀──pipe──


## Features

- **Multi-server aggregation** — Manage multiple MCP subprocesses and auto-aggregate downstream capabilities; tool names stay original in single-server mode and switch to namespace prefixes (`serverName__toolName`) only when multiple servers are configured
- **Streamable HTTP Transport** — Lightweight HTTP server based on `NWListener`, providing `/mcp` endpoint, localhost only
- **Session management** — Independent session per client with secure token identification
- **Process lifecycle** — Crash detection + exponential backoff auto-restart
- **macOS status bar app** — Visual service status, one-click start/stop

## Requirements

- macOS 15.0+
- Swift 6.0+
- Xcode 26.3+ (`xcrun mcpbridge` support)

## Installation```bash
git clone git@github.com:ljh740/XCodeMCPService.git
cd XCodeMCPService

# Build .app (recommended)
bash build-app.sh

# Install to Applications
cp -r "build/XCode MCP Service.app" /Applications/

Build output is at build/XCode MCP Service.app, containing:

Component Path Description
Status bar app Contents/MacOS/XCodeMCPStatusBar Main entry, visual status bar management
CLI service Contents/MacOS/XCodeMCPService Command-line service (for background use)

The packaging script also produces:

Artifact Path Description
Disk image build/XCodeMCPService.dmg Recommended macOS release package
SHA-256 build/XCodeMCPService.dmg.sha256 Disk image checksum
Zip archive build/XCodeMCPService.app.zip Unsigned distributable package
SHA-256 build/XCodeMCPService.app.zip.sha256 Archive checksum

> You can locate standalone binaries with swift build -c release --show-bin-path.

Quick Start

1. Create config file```bash

mkdir -p ~/Library/Application\ Support/XCodeMCPService
``````json
{
"bridge": {
"port": 13339,
"host": "127.0.0.1",
"timeout": 30000,
"logLevel": "info"
},
"servers": [
{
"name": "xcode-tools",
"command": "xcrun",
"args": ["mcpbridge"],
"enabled": true
}
]
}


Save as `~/Library/Application Support/XCodeMCPService/config.json`.

> Without a config file, the service uses built-in defaults (port 13339, auto-start `xcrun mcpbridge`). A default config file is created on first launch.

### 2. Start the service```bash
# Via .app (status bar app)
open "/Applications/XCode MCP Service.app"

# Or via CLI
BIN_DIR="$(swift build -c release --show-bin-path)"
"$BIN_DIR/XCodeMCPService"

# Specify config file
"$BIN_DIR/XCodeMCPService" --config /path/to/config.json

# Via environment variable
CONFIG_PATH=/path/to/config.json "$BIN_DIR/XCodeMCPService"

3. Configure MCP client

Add to your MCP client configuration:```json
{
"mcpServers": {
"local-mcp": {
"type": "http",
"url": "http://127.0.0.1:13339/mcp"
}
}
}


## Configuration Reference

### BridgeConfig

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `port` | Int | `13339` | HTTP listen port |
| `host` | String | `"127.0.0.1"` | Listen address (`127.0.0.1` or `localhost` only) |
| `timeout` | Int | `30000` | Request timeout (ms) |
| `logLevel` | String | `"info"` | Log level: debug / info / warn / error |

### ServerConfig

| Field | Type | Default | Description |
|-------|------|---------|-------------|
| `name` | String | — | Unique server name |
| `command` | String | — | Launch command |
| `args` | [String] | `[]` | Command arguments |
| `env` | {String: String}? | `nil` | Environment variables |
| `enabled` | Bool | `true` | Whether enabled |

### Config file lookup order

1. `--config` CLI argument
2. `CONFIG_PATH` environment variable
3. `~/Library/Application Support/XCodeMCPService/config.json`
4. Built-in defaults (auto-written to default path on first launch)

### Logs

Log files are stored by date in `~/Library/Application Support/XCodeMCPService/logs/` as `yyyy-MM-dd.log`. Also output to stderr.

## Testing```bash
swift test

83 tests covering: HTTP parsing/serialization/routing, session management, ResponseQueue, ID mapping, process lifecycle management, etc.

CI/CD

  • .github/workflows/ci.yml: runs swift build -c release and swift test --parallel on every push and pull request.
  • .github/workflows/release.yml: runs bash build-app.sh on every v* tag push or manual dispatch, then uploads the .app bundle, dmg, zip, and SHA-256 checksum files as workflow artifacts.
  • Tag builds also publish build/XCodeMCPService-.dmg, build/XCodeMCPService-.dmg.sha256, build/XCodeMCPService-.zip, and build/XCodeMCPService-.zip.sha256 to the matching GitHub Release.

License

MIT License

Acknowledgments

  • Model Context Protocol — MCP specification
  • swift-sdk — MCP Swift SDK

常见问题

5 问
答案由本站依据条目字段整理,不引用上游原文
X Code MCP Service 怎么安装?

资料没有给出安装命令,请到官方仓库或文档按说明接入;这类条目多数是生态应用,或尚未发布可安装包。

X Code MCP Service 怎么在客户端里配置?

它的传输方式未标注,在客户端 MCP 配置里按官方文档填写启动命令和参数,保存后重启客户端生效。

X Code MCP Service 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

X Code MCP Service 需要 API Key 吗?

资料标注需要Token认证,使用前准备好对应凭据,并按最小权限配置。

X Code MCP Service 能提供哪些能力?

资料显示能力标签包括 Swift、开发工具、HTTP服务、Token认证。具体工具清单以官方文档为准。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。