
Periphery Code Audit
Wraps the Periphery CLI to surface Swift code analysis through MCP, giving you seven tools for detecting unused code in iOS and macOS projects. You can run basic scans with scan_project, check for redundant public declarations, analyze unused imports, or use scan_with_config for YAML-based workflows. Output comes back as structured JSON that Claude can parse and reason about. Most useful when you're auditing a codebase and want AI assistance identifying dead code, over-scoped declarations, or import bloat without manually running command line scans. Requires Periphery already installed via Homebrew and works with both Xcode projects and Swift Packages.
- GitHub stars
- 2
- tools
- 7
- transport
- STDIO
- last updated
- Nov 17, 2025
Tools
7 toolsPublic tool metadata for what this MCP can expose to an agent.
check_periphery_installedVerify that Periphery CLI is installed and accessible.
Verify that Periphery CLI is installed and accessible.
No parameter schema in public metadata yet.
get_periphery_versionGet the installed version of Periphery.
Get the installed version of Periphery.
No parameter schema in public metadata yet.
scan_projectRun a basic Periphery scan on a project.
Run a basic Periphery scan on a project.
No parameter schema in public metadata yet.
scan_with_configRun Periphery scan using a YAML configuration file.
Run Periphery scan using a YAML configuration file.
No parameter schema in public metadata yet.
analyze_unused_importsFocus specifically on detecting unused imports.
Focus specifically on detecting unused imports.
No parameter schema in public metadata yet.
find_redundant_publicIdentify public declarations that could be internal.
Identify public declarations that could be internal.
No parameter schema in public metadata yet.
scan_with_optionsAdvanced scanning with custom Periphery flags.
Advanced scanning with custom Periphery flags.
No parameter schema in public metadata yet.
Sponsors
Readme
Periphery MCP Server
A Model Context Protocol (MCP) server that wraps the Periphery tool, enabling AI assistants to perform Swift code audits and detect unused code in iOS/macOS projects.
Features
- 7 MCP Tools for comprehensive code analysis
- CLI Integration - Uses Periphery CLI for stability and version flexibility
- JSON Output - Structured, parseable results perfect for AI interpretation
- Flexible Scanning - Support for Xcode projects and Swift Packages
- Advanced Options - Full control over Periphery scan configurations
Quick Start
Using Homebrew (Recommended):
# 1. Install Periphery
brew install peripheryapp/periphery/periphery
# 2. Install Periphery MCP Server
brew tap zyntx-lab/tap
brew install periphery-mcp-server
# 3. Configure Claude Desktop
# Edit: ~/Library/Application Support/Claude/claude_desktop_config.json
# Add:
# "periphery": {
# "command": "/opt/homebrew/bin/periphery-mcp-server"
# }
# 4. Restart Claude Desktop (Cmd+Q then reopen)
# 5. Test it
# In Claude Desktop: "Check if Periphery is installed"
From Source:
Details
- Repository
- github.com/zyntx-lab/periphery-mcp-server
- Website
- github.com/zyntx-lab/periphery-mcp-server
- Category
- Mobile Development
- Package
https://github.com/zyntx-lab/periphery-mcp-server/releases/download/v1.0.0/periphery-mcp-server- Transport
- STDIO
- Registry
- MCP registry, active