🚀 Swift 开发工具 MCP 服务器

🛠️ 通过模型上下文协议（MCP）提供基本的 Swift 和 iOS/macOS 开发工具。将您的AI助手与开发环境连接起来！

✨ 内容概览

🔧 开发环境信息

• 🐦 Swift 版本 - 检查您的 Swift 安装
• 📱 iOS/macOS 模拟器 - 列出所有可用的模拟器
• 🔨 Xcode 详情 - 版本和构建信息
• 📦 Xcode SDK - 所有可用的开发SDK
• 🔗 已连接设备 - 实时检测iOS/macOS设备
• 🍎 macOS 系统信息 - 版本和架构细节
• 📋 多Xcode支持 - 检测并管理多个Xcode版本
• ✅ 环境健康检查 - 全面的开发工具状态检查

🎯 快速开始

📋 要求

• 🍎 macOS 13.0+
• 🐦 Swift 6.1+
• 🔨 Xcode（用于开发工具）

🏗️ 安装

1️⃣ 克隆并构建

git clone <your-repo-url>
cd swift-dev-tools-mcp

# 🐛 调试构建
swift build

# 🚀 发布构建  
swift build -c release

2️⃣ 运行服务器

# 直接运行
swift run swift-dev-tools-mcp

# 或使用可执行文件
.build/release/swift-dev-tools-mcp

🔌 MCP 客户端设置

配置 Claude Desktop:

{
  "mcpServers": {
    "swift-dev-tools": {
      "command": "/path/to/your/.build/arm64-apple-macosx/release/swift-dev-tools-mcp"
    }
  }
}

更新到最新版本

brew update && brew upgrade swift-dev-tools-mcp

🛠️ 可用工具

工具	描述	示例输出
🐦 swift_version	当前 Swift 版本	Apple Swift version 5.9.2
📱 list_simulator	iOS/macOS 模拟器	iPhone 15 Pro (Shutdown)
🔨 xcode_version	Xcode 构建信息	Xcode 15.2 Build 1 5C500b
📦 xcode_sdks	可用 SDK	iOS 17.2 -sdk iphoneos17.2
🔗 connected_devices	实时设备列表	已连接的 iOS/macOS 设备
🍎 macos_version	系统版本	macOS 14.2.1 (23C71)
⚙️ system_architecture	CPU 架构	arm64 或 x86_64
📋 list_xcode_versions	所有 Xcode 安装	Xcode.app (16.1, Build 16B40), Xcode-26.0.0-Beta.4.app (Version 26.0, Build 17A5285i), etc.
✅ developer_tools_status	开发环境健康检查	所有开发工具的状态，✓/✗

🏗️ 架构

使用现代 Swift 工具构建：

• 🌟 Swift MCP SDK - 官方 MCP 协议实现
• 🏛️ Foundation - 系统进程执行
• 💬 Stdio 传输 - 标准 I/O 通信

👨‍💻 开发

📁 项目结构

swift-dev-tools-mcp/
├── 📄 Package.swift      # 包配置
├── 🔒 Package.resolved   # 依赖锁定
├── 📁 Sources/
│   └── 🐦 main.swift    # 服务器实现
└── 📖 README.md         # 本指南

➕ 添加新工具

1. 🎯 定义新的 Tool，包括名称和描述
2. ➕ 在 ListTools 处理程序中添加到 tools 数组
3. 🔀 在 CallTool 处理程序中添加情况
4. ⚙️ 实现系统命令函数

🤝 贡献

1. 🍴 分叉仓库
2. 🌿 创建功能分支
3. ✏️ 修改内容
4. 🧪 添加测试（如果需要）
5. 📤 提交拉取请求

📚 资源

• 🔗 Swift MCP SDK
• 📖 MCP 文档
• 🐛 报告问题

---

💡 小贴士： 该服务器连接了AI助手与您的Swift开发环境，使您的工作流程更加智能和自动化！

🎉 愉快编码！ 🍎✨