Polarion MCP Servers

This repository contains Model Context Protocol (MCP) server implementations for Polarion Application Lifecycle Management (ALM) integration.

MCP Tools are available for Polarion work items, including:

Reading Polarion work items

Projects

PolarionRemoteMcpServer: SSE-based MCP server for server based installations
PolarionMcpServer: Console-based MCP server for Polarion integration for local workstation installations

Running via Docker & Linux Server (Recommended)

From your Linux server, create a directory for your configuration and logs:
```
mkdir -p /opt/polarion-mcp-server
cd /opt/polarion-mcp-server
```

Pull the Docker image:

docker pull tizzolicious/polarion-remote-mcp-server

Create a tailored /opt/polarion-mcp-server/appsettings.json file to your Polarion configuration:

{
  "Logging": {
    "LogLevel": {
      "Default": "Information",
      "Microsoft.AspNetCore": "Warning"
    }
  },
  "AllowedHosts": "*",
  "PolarionClientConfiguration": {
    "ServerUrl": "https://your-polarion-server/",
    "Username": "your-username",
    "Password": "your-password",
    "ProjectId": "your-project-id",
    "TimeoutSeconds": 60
  }
}

Run the Docker container:

docker run -d \
  --name polarion-mcp-server \
  -p 8080:8080 \
  -v appsettings.json:/app/appsettings.json \
  tizzolicious/polarion-remote-mcp-server

The server should now be running. You can access it at http://{{your-server-ip}}:5090/sse.

Configuration Options

The PolarionClientConfiguration section in appsettings.json requires the following settings:

Setting	Description
ServerUrl	URL of your Polarion server (e.g., "https://polarion.example.com/")
Username	Polarion username with appropriate permissions
Password	Password for the Polarion user
ProjectId	ID of the Polarion project to access
TimeoutSeconds	Connection timeout in seconds (default: 60)

Configuring MCP Clients

To configure Cline:

Open Cline's MCP settings UI
Click the "Remote Servers" tab
Set the Server name to "Polarion"
Set the Server URL to "http://{{your-server-ip}}:5090/sse"
Click "Add Server"

To configure Visual Studio Code:

Add the following configuration to your settings.json file:

"servers": {
    "polarion-remote": {
        "type": "sse",
        "url": "ttp://{{your-server-ip}}:8080/sse",
        "env": {}
    }    
}

To Claude Desktop:

Claude Desktop currently doesn’t support SSE, but you can use a proxy with the following addition to the claude_desktop_config.json file:

{
  "mcpServers": {
    "polarion-remote": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "http://{{your-server-ip}}:8080/sse"
      ]
    }
  }
}

Building the Projects

Prerequisites

.NET 9.0 SDK or later
Docker (for container deployment)

Building Locally

To build the projects locally:

dotnet build PolarionMcpServers.sln

Building Docker Image

dotnet publish PolarionRemoteMcpServer/PolarionRemoteMcpServer.csproj /t:PublishContainer

Publishing to a Docker Registry

dotnet publish PolarionRemoteMcpServer/PolarionRemoteMcpServer.csproj /t:PublishContainer -p ContainerRegistry=your-registery

Categories

Current Category: alm

PolarionMcpServers