applesign-mcp-server

A Model Context Protocol (MCP) server for iOS app signing. This package allows you to sign iOS IPA files using the MCP protocol, making it easy to integrate with AI assistants and other tools that support MCP.

Installation

npm install -g applesign-mcp-server

Or use it directly with npx:

npx applesign-mcp-server

Usage with MCP Configuration

You can use this MCP server in your MCP configuration:

{
  "mcpServers": {
    "applesign": {
      "command": "npx",
      "args": ["-y", "applesign-mcp-server"]
    }
  }
}

Available Tools

sign_ipa

Sign an IPA file with the specified options.

Parameters:

• ipa_path (required): Path to the IPA file to sign
• mobileprovision (optional): Path to the mobileprovision file
• bundleid (optional): New bundle ID for the app
• identity (optional): Identity to use for signing
• without_plugins (optional): Remove plugins from the IPA (default: false)
• without_watchapp (optional): Remove WatchApp from the IPA (default: false)
• without_xctests (optional): Remove XCTests from the IPA (default: false)
• output (optional): Output path for the signed IPA

Example:

{
  "type": "tool",
  "tool": "sign_ipa",
  "arguments": {
    "ipa_path": "/path/to/app.ipa",
    "mobileprovision": "/path/to/profile.mobileprovision",
    "bundleid": "com.example.app",
    "without_plugins": true
  }
}

list_identities

List available signing identities.

Parameters: None

Example:

{
  "type": "tool",
  "tool": "list_identities",
  "arguments": {}
}

Available Resources

applesign://identities

List of available signing identities.

Example:

{
  "type": "resource",
  "uri": "applesign://identities"
}

Converting from Command Line to MCP

If you're currently using the command line version of applesign, you can convert your commands to MCP tool calls. For example:

Command line:

applesign -p -m /path/to/profile.mobileprovision -b com.example.app app.ipa

MCP tool call:

{
  "type": "tool",
  "tool": "sign_ipa",
  "arguments": {
    "ipa_path": "app.ipa",
    "mobileprovision": "/path/to/profile.mobileprovision",
    "bundleid": "com.example.app",
    "without_plugins": true
  }
}

Manual Usage

You can also use the MCP server manually by sending JSON requests to its stdin and reading responses from its stdout:

echo '{"type":"metadata"}' | npx applesign-mcp-server

This will return metadata about the server, including available tools and resources.

License

MIT