# Polarion MCP Server
A Model Context Protocol (MCP) server for interacting with Siemens Polarion requirements management system. No Docker required!
## Features
- 🔐 **Authentication** - Browser-based login with manual token generation
- 📋 **Projects** - List and get detailed project information
- 📝 **Work Items** - Query requirements, tasks, and other work items
- 📄 **Documents** - Access Polarion documents and spaces
- 🔍 **Flexible queries** - Filter work items with custom queries
- ⚡ **Lightweight** - Optimized API calls with configurable field sets
- 📦 **Easy Installation** - One command to get started
## Quick Start (30 seconds)
### Installation
**Option A: Using `pip` (Recommended)**
```bash
pip install polarion-mcp
```
**Option B: Using `uvx` (No local Python needed)**
Just use directly in mcp.json (see setup below).
### Setup
1. **Add to your Cursor mcp.json:**
```json
{
"mcpServers": {
"polarion": {
"command": "polarion-mcp"
}
}
}
```
2. **Restart Cursor**
3. **In Cursor chat, authenticate:**
```
Open Polarion login
Set Polarion token: <your-token>
```
Done! 🎉
## Configuration
### Connect to Your Polarion Instance
By default connects to `http://dev.polarion.atoms.tech/polarion`. To use your own instance:
**Option 1: Environment Variable**
```bash
export POLARION_BASE_URL="https://your-polarion.com/polarion"
polarion-mcp
```
**Option 2: In Cursor mcp.json**
```json
{
"mcpServers": {
"polarion": {
"command": "polarion-mcp",
"env": {
"POLARION_BASE_URL": "https://your-polarion.com/polarion"
}
}
}
}
```
**Option 3: Using uvx with custom URL**
```json
{
"mcpServers": {
"polarion": {
"command": "uvx",
"args": ["polarion-mcp@latest"],
"env": {
"POLARION_BASE_URL": "https://your-polarion.com/polarion"
}
}
}
}
```
## Available Tools
Once authenticated, use these commands in Cursor:
**Authentication**
- `Open Polarion login` - Opens browser to Polarion login
- `Set Polarion token: <token>` - Saves authentication token
- `Check Polarion status` - Verify authentication
**Projects**
- `Get Polarion projects` - List all projects
- `Get Polarion project: PROJECT_ID` - Get project details
**Work Items**
- `Get Polarion work items: PROJECT_ID` - List work items
- `Get Polarion work items: PROJECT_ID (query: "HMI AND type:requirement")` - Filter results
- `Get Polarion work item: PROJECT_ID ITEM_ID` - Get item details
**Documents**
- `Get Polarion document: PROJECT_ID SPACE_ID DOCUMENT_NAME` - Access documents
**Analysis**
- `polarion_github_requirements_coverage project_id="PROJECT" topic="HMI"` - Requirements coverage
## Local Development
### Prerequisites
- Python 3.10+
- Access to Polarion instance
### Installation
```bash
git clone https://github.com/Sdunga1/Polarion-MCP.git
cd Polarion-MCP
pip install -e .
```
### Running
```bash
polarion-mcp
```
## Troubleshooting
**Can't connect?**
- Verify `POLARION_BASE_URL` is correct
- Check if Polarion instance is accessible
- Verify token hasn't expired
**Authentication failed?**
- Regenerate token in Polarion
- Use: `Open Polarion login` → `Set Polarion token`
- Check: `Check Polarion status`
**Not finding projects?**
- Verify user has access to projects in Polarion
- Check authentication: `Check Polarion status`
## Resources
- **GitHub**: [Polarion-MCP](https://github.com/Sdunga1/Polarion-MCP)
- **PyPI**: [polarion-mcp](https://pypi.org/project/polarion-mcp)
- **Issues**: [Report a bug](https://github.com/Sdunga1/Polarion-MCP/issues)
## License
MIT
Raw data
{
"_id": null,
"home_page": null,
"name": "polarion-mcp",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.10",
"maintainer_email": null,
"keywords": "mcp, model-context-protocol, polarion, requirements",
"author": "ATOMS Team",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/96/ab/73f6e08bda96656363d9de1ecca7a9ae5cf5b3c9e38901d645be0661bf62/polarion_mcp-0.1.1.tar.gz",
"platform": null,
"description": "# Polarion MCP Server\n\nA Model Context Protocol (MCP) server for interacting with Siemens Polarion requirements management system. No Docker required!\n\n## Features\n\n- \ud83d\udd10 **Authentication** - Browser-based login with manual token generation\n- \ud83d\udccb **Projects** - List and get detailed project information\n- \ud83d\udcdd **Work Items** - Query requirements, tasks, and other work items\n- \ud83d\udcc4 **Documents** - Access Polarion documents and spaces\n- \ud83d\udd0d **Flexible queries** - Filter work items with custom queries\n- \u26a1 **Lightweight** - Optimized API calls with configurable field sets\n- \ud83d\udce6 **Easy Installation** - One command to get started\n\n## Quick Start (30 seconds)\n\n### Installation\n\n**Option A: Using `pip` (Recommended)**\n\n```bash\npip install polarion-mcp\n```\n\n**Option B: Using `uvx` (No local Python needed)**\nJust use directly in mcp.json (see setup below).\n\n### Setup\n\n1. **Add to your Cursor mcp.json:**\n\n```json\n{\n \"mcpServers\": {\n \"polarion\": {\n \"command\": \"polarion-mcp\"\n }\n }\n}\n```\n\n2. **Restart Cursor**\n\n3. **In Cursor chat, authenticate:**\n\n```\nOpen Polarion login\nSet Polarion token: <your-token>\n```\n\nDone! \ud83c\udf89\n\n## Configuration\n\n### Connect to Your Polarion Instance\n\nBy default connects to `http://dev.polarion.atoms.tech/polarion`. To use your own instance:\n\n**Option 1: Environment Variable**\n\n```bash\nexport POLARION_BASE_URL=\"https://your-polarion.com/polarion\"\npolarion-mcp\n```\n\n**Option 2: In Cursor mcp.json**\n\n```json\n{\n \"mcpServers\": {\n \"polarion\": {\n \"command\": \"polarion-mcp\",\n \"env\": {\n \"POLARION_BASE_URL\": \"https://your-polarion.com/polarion\"\n }\n }\n }\n}\n```\n\n**Option 3: Using uvx with custom URL**\n\n```json\n{\n \"mcpServers\": {\n \"polarion\": {\n \"command\": \"uvx\",\n \"args\": [\"polarion-mcp@latest\"],\n \"env\": {\n \"POLARION_BASE_URL\": \"https://your-polarion.com/polarion\"\n }\n }\n }\n}\n```\n\n## Available Tools\n\nOnce authenticated, use these commands in Cursor:\n\n**Authentication**\n\n- `Open Polarion login` - Opens browser to Polarion login\n- `Set Polarion token: <token>` - Saves authentication token\n- `Check Polarion status` - Verify authentication\n\n**Projects**\n\n- `Get Polarion projects` - List all projects\n- `Get Polarion project: PROJECT_ID` - Get project details\n\n**Work Items**\n\n- `Get Polarion work items: PROJECT_ID` - List work items\n- `Get Polarion work items: PROJECT_ID (query: \"HMI AND type:requirement\")` - Filter results\n- `Get Polarion work item: PROJECT_ID ITEM_ID` - Get item details\n\n**Documents**\n\n- `Get Polarion document: PROJECT_ID SPACE_ID DOCUMENT_NAME` - Access documents\n\n**Analysis**\n\n- `polarion_github_requirements_coverage project_id=\"PROJECT\" topic=\"HMI\"` - Requirements coverage\n\n## Local Development\n\n### Prerequisites\n\n- Python 3.10+\n- Access to Polarion instance\n\n### Installation\n\n```bash\ngit clone https://github.com/Sdunga1/Polarion-MCP.git\ncd Polarion-MCP\npip install -e .\n```\n\n### Running\n\n```bash\npolarion-mcp\n```\n\n## Troubleshooting\n\n**Can't connect?**\n\n- Verify `POLARION_BASE_URL` is correct\n- Check if Polarion instance is accessible\n- Verify token hasn't expired\n\n**Authentication failed?**\n\n- Regenerate token in Polarion\n- Use: `Open Polarion login` \u2192 `Set Polarion token`\n- Check: `Check Polarion status`\n\n**Not finding projects?**\n\n- Verify user has access to projects in Polarion\n- Check authentication: `Check Polarion status`\n\n## Resources\n\n- **GitHub**: [Polarion-MCP](https://github.com/Sdunga1/Polarion-MCP)\n- **PyPI**: [polarion-mcp](https://pypi.org/project/polarion-mcp)\n- **Issues**: [Report a bug](https://github.com/Sdunga1/Polarion-MCP/issues)\n\n## License\n\nMIT\n",
"bugtrack_url": null,
"license": "MIT",
"summary": "Polarion MCP Server - Model Context Protocol integration for Siemens Polarion ALM",
"version": "0.1.1",
"project_urls": {
"Documentation": "https://github.com/Sdunga1/Polarion-MCP/blob/main/README.md",
"Homepage": "https://github.com/Sdunga1/Polarion-MCP",
"Issues": "https://github.com/Sdunga1/Polarion-MCP/issues",
"Repository": "https://github.com/Sdunga1/Polarion-MCP.git"
},
"split_keywords": [
"mcp",
" model-context-protocol",
" polarion",
" requirements"
],
"urls": [
{
"comment_text": null,
"digests": {
"blake2b_256": "c482cfec6530dd29faf630a624ca86484695f28437fef773fabf7bec1eee2706",
"md5": "39df4743e976c5533bec993bc928424e",
"sha256": "9f63258df7a9780b87976f00272bb8c18bb6c3c27ac7f2c4df5b1329713869c2"
},
"downloads": -1,
"filename": "polarion_mcp-0.1.1-py3-none-any.whl",
"has_sig": false,
"md5_digest": "39df4743e976c5533bec993bc928424e",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.10",
"size": 12858,
"upload_time": "2025-10-24T01:42:50",
"upload_time_iso_8601": "2025-10-24T01:42:50.928372Z",
"url": "https://files.pythonhosted.org/packages/c4/82/cfec6530dd29faf630a624ca86484695f28437fef773fabf7bec1eee2706/polarion_mcp-0.1.1-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": null,
"digests": {
"blake2b_256": "96ab73f6e08bda96656363d9de1ecca7a9ae5cf5b3c9e38901d645be0661bf62",
"md5": "927da724ad3a5fa19648528c58634e6c",
"sha256": "624e1ad123a57eb0f00a2f6453118185b5c4fa3962dd41d95b54c6a07a1a6ef1"
},
"downloads": -1,
"filename": "polarion_mcp-0.1.1.tar.gz",
"has_sig": false,
"md5_digest": "927da724ad3a5fa19648528c58634e6c",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.10",
"size": 60192,
"upload_time": "2025-10-24T01:42:52",
"upload_time_iso_8601": "2025-10-24T01:42:52.060988Z",
"url": "https://files.pythonhosted.org/packages/96/ab/73f6e08bda96656363d9de1ecca7a9ae5cf5b3c9e38901d645be0661bf62/polarion_mcp-0.1.1.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2025-10-24 01:42:52",
"github": true,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"github_user": "Sdunga1",
"github_project": "Polarion-MCP",
"github_not_found": true,
"lcname": "polarion-mcp"
}
JSON
