a-25/ios-mcp-code-quality-server

이 페이지는 AI로 자동 번역되었습니다. 기술적인 세부 사항은 원문을 확인하세요. 원문 보기

12 stars 3 forks 품질 62 트렌드 19MIT

This server enables AI assistants to run Xcode tests, perform linter analysis, and provide detailed feedback on iOS projects through structured, actionable reports.

개요

A versatile iOS code quality analysis tool that operates in two modes: 1. : Direct command-line interface for iOS testing and linting 2. : Model Context Protocol server for AI assistant integration This tool provides comprehensive iOS code quality analysis and test automation capabilities, enabling both direct developer usage and AI assistant integration for Xcode tests, linter analysis, and detailed feedback on iOS projects through structured, actionable reports. For frequent use across multiple projects, you can install globally: Using npx is recommended as it ensures you always use the latest version without global installs. The server will start on http://localhost:3000 and be ready to receive MCP requests.

README

원문 README의 일부입니다. 원문 보기.

iOS MCP Code Quality Server

A versatile iOS code quality analysis tool that operates in two modes:

CLI Tool: Direct command-line interface for iOS testing and linting
MCP Server: Model Context Protocol server for AI assistant integration

This tool provides comprehensive iOS code quality analysis and test automation capabilities, enabling both direct developer usage and AI assistant integration for Xcode tests, linter analysis, and detailed feedback on iOS projects through structured, actionable reports.

Quick Start

CLI Mode (Direct Usage with npx - Recommended)

Use instantly without installation:

# Run iOS tests
npx ios-mcp-code-quality-server test --xcworkspace MyApp.xcworkspace --scheme MyAppTests

# Run SwiftLint analysis
npx ios-mcp-code-quality-server lint --changed-files "ViewController.swift,Model.swift"

# Show help
npx ios-mcp-code-quality-server --help

Alternative: Install Globally (Optional)

For frequent use across multiple projects, you can install globally:

npm install -g ios-mcp-code-quality-server

# Then use the full name (following MCP conventions)
ios-mcp-code-quality-server test --xcworkspace MyApp.xcworkspace --scheme MyAppTests
ios-mcp-code-quality-server lint --changed-files "ViewController.swift,Model.swift"

💡 Tip: Using npx is recommended as it ensures you always use the latest version without global installs.

MCP Server Mode (AI Assistant Integration)

# Start as MCP server (no arguments)
npx ios-mcp-code-quality-server

# Or explicitly start server mode
npx ios-mcp-code-quality-server server

The server will start on http://localhost:3000 and be ready to receive MCP requests.

Features

🧪 iOS Test Execution: Run Xcode tests with detailed failure analysis
📱 Multiple Schemes Support: Test different iOS project configurations
🔍 SwiftLint Integration: Automated Swift code style and quality checking
📊 Structured Reporting: Clear, actionable feedback with file locations and line numbers
🛠 Build Error Detection: Intelligent parsing of Xcode build failures
🔒 Local Processing: All analysis happens on your machine for security
⚡ Dual Mode Operation: Use as CLI tool or MCP server
💻 Command Line Interface: Direct terminal usage for developers
🤖 AI Assistant Ready: MCP protocol support for seamless AI integration

Architecture

This tool operates in two distinct modes with intelligent detection:

CLI Mode

Activation: When command-line arguments are provided
Usage: Direct developer interaction via terminal commands or npx
Output: Human-readable or JSON format for scripting

GitHub에서 전체 README 보기

설치

npx ios-mcp-code-quality-server test --xcworkspace MyApp.xcworkspace --scheme MyAppTests

MCP 초보자라면? mcpskill.org 가이드부터 시작하세요 →

설정

{
  "mcpServers": {
    "ios-code-quality": {
      "url": "http://localhost:3000",
      "timeout": 30000
    }
  }
}