Pero

You run the Pero MCP Server to access and orchestrate multiple client integrations, including SSH session management and App Store Connect interactions. This server lets you securely connect to remote hosts, execute commands, transfer files, and manage App Store assets from a single, extensible MCP interface.

How to use

Start the MCP server in your environment and connect through an MCP client. You will interact with two primary capabilities: SSH for secure remote access and file operations, and App Store Connect for managing applications, teams, and TestFlight workflows. Use the SSH tools to establish connections, run remote commands, and transfer files. Use the App Store tools to list your apps, view team members, and manage TestFlight versions.

In practice, you will import or enable the configured MCP clients, then call the provided tools from your MCP client interface. For SSH, you can establish a connection, execute commands, and upload or download files. For App Store Connect, you can retrieve apps, fetch team members, and perform TestFlight-related tasks. The server coordinates these actions and returns structured results suitable for your client UI.

How to install

Prerequisites: ensure Python 3.8 or newer is installed on your system. You also need access to the required Python dependencies listed in the project requirements.

Install the dependencies using the following command to prepare the runtime environment.

pip install -r requirements.txt

Configuration and startup details

You will run the MCP server in stdio mode for a local development setup, or you can run it remotely in a production environment. The following configurations show how to start the server in each scenario.

Local development startup uses a Python invocation that runs the MCP server script directly with environment variables for SSH and App Store Connect access.

Remote production startup uses a runtime command that fetches the server from the repository and runs the server with appropriate environment variables.

MCP server configurations

The MCP server supports multiple startup configurations. Below are two explicit examples: a local development setup and a remote production setup. Each configuration includes the command to run, the arguments, and the environment variables required.

{
  "servers": {
    "pero_mcp_local": {
      "command": "python",
      "args": [
        "path/to/pero-mcp-server"
      ],
      "env": {
        "SSH_HOST": "your_ssh_host",
        "SSH_USERNAME": "your_username",
        "SSH_PORT": "22",
        "SSH_PASSWORD": "your_password",
        "APPSTORE_KEY_ID": "your_key_id",
        "APPSTORE_ISSUER_ID": "your_issuer_id",
        "APPSTORE_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\nyour_private_key_content\n-----END PRIVATE KEY-----"
      }
    },
    "pero_mcp_remote": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/peroperogames/pero-mcp-server",
        "pero-mcp-server"
      ],
      "env": {
        "SSH_HOST": "your_production_ssh_host",
        "SSH_USERNAME": "your_ssh_username",
        "SSH_PORT": "22",
        "SSH_PASSWORD": "your_ssh_password",
        "APPSTORE_KEY_ID": "your_appstore_key_id",
        "APPSTORE_ISSUER_ID": "your_appstore_issuer_id",
        "APPSTORE_PRIVATE_KEY": "-----BEGIN PRIVATE KEY-----\nyour_private_key_content\n-----END PRIVATE KEY-----"
      }
    }
  }
}

Security and best practices

Do not store real passwords or private keys in code or plain text configuration files. Use environment variables or secure configuration management. Rotate SSH credentials and API keys regularly, and ensure private keys have restricted file permissions.

Available tools and resources

SSH tools enable you to establish connections, run commands, and transfer files. App Store tools enable you to configure credentials, fetch applications, and retrieve team member information.

Available tools

ssh_connect

Establish an SSH connection to a remote host to enable secure remote operations.

ssh_execute

Execute a remote command on a connected SSH session.

ssh_upload

Upload a file to a remote host over the SSH session.

ssh_download

Download a file from a remote host over the SSH session.

configure_appstore

Configure App Store Connect credentials for API access.

get_apps

Retrieve the list of apps in App Store Connect.

get_team_members

Fetch team member information from App Store Connect.