alm-mcp

# Polarion ALM MCP Server A Model Context Protocol (MCP) server for Polarion ALM (Application Lifecycle Management) integration. This server provides comprehensive tools for managing projects, work items, attachments, comments, linked work items, and other ALM operations through the Polarion REST API. ## Features - **Project Management**: List and retrieve project information with flexible field filtering - **Work Item Operations**: Create, read, update, delete, and query work items with full relationship support - **Assignee Management**: Add and retrieve work item assignees - **Attachment Handling**: Upload, list, download, and remove attachments - **Comment System**: Add, list, update, and remove comments with structured data support - **Linked Work Items**: Create, update, delete, and query linked work items with role-based relationships - **Advanced Query Support**: Comprehensive query parameters including pagination, field filtering, and includes - **Relationship Management**: Detailed support for assignees, categories, linked revisions, votes, and watches ## Installation ### Option 1: Local Development Setup 1. Clone this repository: ```bash git clone <repository-url> cd alm-mcp ``` 2. Install dependencies: ```bash pip install -r requirements.txt ``` 3. Set up environment variables (optional): ```bash cp .env.example .env # Edit .env with your Polarion credentials ``` ### Option 2: Package Installation (Future) ```bash # For future package distribution uvx alm-mcp # or pip install alm-mcp ``` ## Configuration The MCP server supports multiple configuration methods with the following priority: 1. **Command line arguments** (highest priority) 2. **Environment variables** (lower priority) ### Authentication For security reasons, only **personal access tokens** are supported: - `POLARION_ACCESS_TOKEN` or `--access-token` ### Environment Variables Create a `.env` file with the following variables: ```env POLARION_BASE_URL=your-alm-base-url POLAR…