zyntx-lab avatar

Periphery Code Audit

zyntx-lab/periphery-mcp-server

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 tools

Public 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:


View the full README on GitHub

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

Related Mobile Development MCP servers

View all
1antoinedelorme avatarKweenkl Mcpantoinedelorme/kweenkl-mcpPush notifications for AI agents - send instant iPhone notifications from any MCP client.0stars
2clauxel avatarAistudioandroidreleasegate Mcpclauxel/ai-studio-android-release-gate-mcpRemote MCP for AI Studio Android release gate MCP, structured receipts, audit logs, and reviewer-rea0stars
3mutonby avataragentringmutonby/agentringLet your AI agent message and call your Android phone, and get your reply or the call transcript.376stars
4cafetechne avatarAntigravity Linkcafetechne/antigravity-link-extensionMCP server and OpenAPI-backed mobile companion for controlling Antigravity IDE sessions187stars
5whats2000 avatarIsaacsim Mcp Serverwhats2000/isaacsim-mcp-serverControl NVIDIA Isaac Sim robotics simulator through MCP with 42 tools70stars
6briangaoo avatarWhoop Mcpbriangaoo/whoop-mcpFull read + write access to your Whoop fitness data via the private iOS API. 48 tools.67stars