🚀 Swift Dev Tools MCP Server
🛠️ Essential Swift & iOS/macOS development tools through the Model Context Protocol (MCP). Bridge your AI assistants with your development environment!
✨ What's Inside
🔧 Development Environment Info
- 🐦 Swift Version - Check your Swift installation
- 📱 iOS/macOS Simulators - List all available simulators
- 🔨 Xcode Details - Version and build information
- 📦 Xcode SDKs - All available development SDKs
- 🔗 Connected Devices - Live iOS/macOS device detection
- 🍎 macOS System Info - Version and architecture details
- 📋 Multiple Xcode Support - Detect and manage multiple Xcode versions
- ✅ Environment Health - Comprehensive development tools status check
🎯 Quick Start
📋 Requirements
- 🍎 macOS 13.0+
- 🐦 Swift 6.1+
- 🔨 Xcode (for dev tools)
🏗️ Installation
1️⃣ Clone & Build
git clone <your-repo-url>
cd swift-dev-tools-mcp
# 🐛 Debug build
swift build
# 🚀 Release build
swift build -c release
2️⃣ Run the Server
# Direct run
swift run swift-dev-tools-mcp
# Or use executable
.build/release/swift-dev-tools-mcp
🔌 MCP Client Setup
Configure Claude Desktop:
{
"mcpServers": {
"swift-dev-tools": {
"command": "/path/to/your/.build/arm64-apple-macosx/release/swift-dev-tools-mcp"
}
}
}
To get upgrade to latest one
brew update && brew upgrade swift-dev-tools-mcp
🛠️ Available Tools
| Tool | Description | Example Output |
|------|-------------|----------------|
| 🐦 swift_version | Current Swift version | Apple Swift version 5.9.2 |
| 📱 list_simulator | iOS/macOS simulators | iPhone 15 Pro (Shutdown) |
| 🔨 xcode_version | Xcode build info | Xcode 15.2 Build 15C500b |
| 📦 xcode_sdks | Available SDKs | iOS 17.2 -sdk iphoneos17.2 |
| 🔗 connected_devices | Live device list | Connected iOS/macOS devices |
| 🍎 macos_version | System version | macOS 14.2.1 (23C71) |
| ⚙️ system_architecture | CPU architecture | arm64 or x86_64 |
| 📋 list_xcode_versions | All Xcode installations | Xcode.app (16.1, Build 16B40), Xcode-26.0.0-Beta.4.app (Version 26.0, Build 17A5285i), etc. |
| ✅ developer_tools_status | Dev environment health check | Status of all dev tools with ✓/✗ |
🏗️ Architecture
Built with modern Swift tools:
- 🌟 Swift MCP SDK - Official MCP protocol implementation
- 🏛️ Foundation - System process execution
- 💬 Stdio Transport - Standard I/O communication
👨💻 Development
📁 Project Structure
swift-dev-tools-mcp/
├── 📄 Package.swift # Package configuration
├── 🔒 Package.resolved # Dependency lock
├── 📁 Sources/
│ └── 🐦 main.swift # Server implementation
└── 📖 README.md # This guide
➕ Adding New Tools
- 🎯 Define new
Tool with name & description
- ➕ Add to
tools array in ListTools handler
- 🔀 Add case in
CallTool handler
- ⚙️ Implement system command function
🤝 Contributing
- 🍴 Fork the repository
- 🌿 Create feature branch
- ✏️ Make your changes
- 🧪 Add tests (if needed)
- 📤 Submit pull request
📚 Resources
💡 Pro Tip: This server bridges the gap between AI assistants and your Swift development environment, making your workflow more intelligent and automated!
🎉 Happy Coding! 🍎✨
