Port IO

Installation# Prerequisites

Before you begin, you'll need:

1. Create a Port Account (if you don't have one):

• Visit Port.io
• Sign up for an account

2. Obtain Port Credentials:

• Navigate to your Port dashboard
• Go to Settings > Credentials
• Save both the Client ID and Client Secret

3. Installation Requirements:

• Either Docker installed on your system
• OR uvx package manager installed

Installation methods

Port MCP Server can be installed using two methods:

Package Installation (uvx)

Use our official Port MCP server package with uvx for easy installation and management.

Step-by-Step Installation Guide

1. Create a Python Virtual Environment (Recommended)

   python -m venv venv
   

2. Activate the Virtual Environment

   # On Linux/macOS: source venv/bin/activate
   # On Windows: venv\Scripts\activate
   

3. Install the UV Package Manager

   # Using Homebrew (macOS/Linux): brew install uv
   # Or using pip: pip install uv
   

4. Verify UV Installation

   which uv
   

5. Set Required Environment Variables

   export PORT_CLIENT_ID="your_port_client_id"
   export PORT_CLIENT_SECRET="your_port_client_secret"
   export PORT_REGION="EU" # or "US"
   

6. Set Python Path (if using virtual environment)

   export PYTHONPATH="/path/to/your/venv/bin/python"
   

7. Run the MCP Server

   uvx mcp-server-port --client-id your_port_client_id --client-secret your_port_client_secret --region EU --log-level DEBUG
   

8. Verify Server is Running You should start seeing logs from the server. You can also check the log file:

   cat /tmp/port-mcp.log
   

Docker Installation

Use our official Docker image:

docker pull ghcr.io/port-labs/port-mcp-server:latest