Swift Selena - Swift Analyzer MCP Server with respect to Serena

Swift Selena is an MCP (Model Context Protocol) server that provides Swift code analysis capabilities to Claude AI. It works even with build errors and strongly supports SwiftUI app development.

日本語版はこちら / Japanese version

Key Features

• Build-Free: Works even with build errors through SwiftSyntax-based static analysis
• LSP Integration: Advanced features with SourceKit-LSP when project is buildable (v0.5.1+)
• Meta Tool Mode: Reduces context window usage with dynamic tool loading (v0.6.2+)
• Swift Testing Support: Detects both XCTest and Swift Testing (@Test, @Suite) test cases
• SwiftUI Support: Automatically detects Property Wrappers (@State, @Binding, etc.)
• Fast Search: Filesystem-based search for fast performance even on large projects
• Smart Caching: Caches analysis results for fast repeated queries
• Multi-Client Support: Use with Claude Code and Claude Desktop simultaneously

Provided Tools

Meta Tool Mode (v0.6.2+)

Swift-Selena uses a Meta Tool Mode that exposes only 4 tools to Claude, reducing context window usage. The actual analysis tools are loaded dynamically on demand.

Exposed Tools:

• initialize_project - Initialize a project (must be called first)
• list_available_tools - List all available analysis tools with descriptions
• get_tool_schema - Get the JSON schema for a specific tool
• execute_tool - Execute any analysis tool by name

Available Analysis Tools (via execute_tool)

File Search

• find_files - Search files by wildcard pattern (e.g., *ViewModel.swift)
• search_code - Search code content using regex
• search_files_without_pattern - Search files WITHOUT a pattern (grep -L equivalent)

Symbol Analysis

• list_symbols - List all symbols (Class, Struct, Function, etc.)
• find_symbol_definition - Find symbol definitions across the project

SwiftUI Analysis

• list_property_wrappers - Detect SwiftUI Property Wrappers (@State, @Binding, etc.)
• list_protocol_conformances - Analyze protocol conformances and inheritance (UITableViewDelegate, ObservableObject, etc.)
• list_extensions - Analyze extensions (extended type, protocol conformance, members)

Code Analysis

• analyze_imports - Analyze import dependencies across the project (module usage statistics, cached)
• get_type_hierarchy - Get type inheritance hierarchy (superclass, subclasses, conforming types, cached)
• find_test_cases - Detect XCTest and Swift Testing (@Test, @Suite) test cases

Installation

Requirements

• macOS 13.0 or later
• Swift 5.9 or later
• Claude Desktop or Claude Code

Build Steps

# Clone the repository
git clone https://github.com/BlueEventHorizon/Swift-Selena.git
cd Swift-Selena

# Build (release mode for production)
make build-release

# Or using swift directly:
# swift build -c release -Xswiftc -Osize

The build artifact is generated at .build/release/Swift-Selena.

Available Make Commands

make help  # Show all available commands

Build

| Command | Description | |---------|-------------| | make build | Build debug version | | make build-release | Build release version | | make clean | Clean build artifacts |

Register / Unregister

| Command | Target | Description | |---------|--------|-------------| | make register-release | Claude Code | Register RELEASE version (prompts for project path) | | make unregister-release | Claude Code | U

... View full README on GitHub