Pepper

v1.0.0Developer Toolsstable

iOS dynamic library MCP for agents

accessibilityai-agentclaudedebuggingdylib
Share:
89
Stars
0
Downloads
0
Weekly
0/5

What is Pepper?

Pepper is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to ios dynamic library mcp for agents

iOS dynamic library MCP for agents

This server falls under the Developer Tools category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • iOS dynamic library MCP for agents

Use Cases

Access iOS app internals and simulator state through dynamic libraries.
Debug and inspect iOS applications from Claude.
Enable accessibility and debugging features in iOS apps.
skwallace36

Maintainer

LicenseMIT
Languageswift
Versionv1.0.0
UpdatedMay 20, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

Manual Installation

npx pepper

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use Pepper

Pepper is a Swift-based MCP server and iOS dynamic library that gives AI agents deep programmatic access to iOS Simulator internals, exposing over 60 tools covering UI inspection, native touch interaction, network monitoring, memory analysis, debugging, and system state access. Developers use it to let Claude autonomously test, debug, and inspect iOS apps running in the simulator without modifying application source code—injecting the Pepper dylib at runtime via the `pepper-ctl` CLI. It enables accessibility audits, crash log capture, CoreData inspection, UserDefaults querying, and hitching detection entirely through conversational prompts.

Prerequisites

  • macOS 14 (Sonoma) or later
  • Python 3.10 or higher (for pepper-ios pip package)
  • Xcode with iOS Simulator installed and at least one simulator running
  • An MCP-compatible client such as Claude Desktop or Claude Code
1

Install the pepper-ios Python package

Install the package via pip, which provides both the pepper-mcp server binary and the pepper-ctl deployment CLI.

pip install pepper-ios
2

Launch an iOS Simulator

Open Xcode and start an iOS Simulator, then launch the app you want to inspect inside it.

open -a Simulator
3

Inject Pepper into the frontmost simulator app

Run pepper-ctl deploy to inject the Pepper dynamic library into the currently frontmost app in the simulator.

pepper-ctl deploy
4

Configure your MCP client to use Pepper

Add pepper-mcp to your MCP client configuration. The server binary is installed by pip and available on your PATH.

5

Restart your MCP client and start inspecting

Restart Claude Desktop or your MCP client. You can now use conversational prompts to inspect the UI, tap elements, check memory, or capture logs.

Pepper Examples

Client configuration

Claude Desktop configuration for the Pepper iOS simulator MCP server.

{
  "mcpServers": {
    "pepper": {
      "command": "pepper-mcp"
    }
  }
}

Prompts to try

Example prompts for inspecting and interacting with iOS apps via Pepper.

- "Show me the current view hierarchy of the frontmost iOS simulator app"
- "Tap the Settings button in the app"
- "Run an accessibility audit on the current screen and list any violations"
- "Check UserDefaults for the key 'user_id' in the running app"
- "Capture the last 50 console log lines from the simulator app"
- "Inspect CoreData and list all entity names in the app's persistent store"

Troubleshooting Pepper

pepper-ctl deploy fails with a permission or injection error

Ensure the simulator is running and the target app is the frontmost application. Some sandboxed apps may resist dylib injection — use a debug build of the app for best results.

pepper-mcp command not found after pip install

The pip install puts pepper-mcp in your Python scripts directory. Run `pip show pepper-ios` to find the install location and ensure that directory is on your PATH, or use the full path to the binary.

macOS version incompatibility error on startup

Pepper requires macOS 14 (Sonoma) or later. Run `sw_vers` to check your macOS version. Older macOS versions are not supported.

Frequently Asked Questions about Pepper

What is Pepper?

Pepper is a Model Context Protocol (MCP) server that ios dynamic library mcp for agents It connects AI assistants to external tools and data sources through a standardized interface.

How do I install Pepper?

Follow the installation instructions on the Pepper GitHub repository. Clone the repo, install dependencies, and add the server config to your AI client.

Which AI clients work with Pepper?

Pepper works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is Pepper free to use?

Yes, Pepper is open source and available under the MIT license. You can use it freely in both personal and commercial projects.

Browse More Developer Tools MCP Servers

Explore all developer tools servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "pepper": { "command": "npx", "args": ["-y", "pepper"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use Pepper?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides