Polarion MCP

Name: Polarion MCP
Author: devemberx

@devemberx

关于 Polarion MCP

MCP server for Polarion ALM — read and write documents, work items, test runs, traceability links, and comments from any MCP-compatible AI assistant

#polarion #mcp

基本信息

分类

其他

传输方式

stdio

发布者

devemberx

提交者

데브엠버

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "mcp-server-polarion": {
      "command": "uvx",
      "args": [
        "mcp-server-polarion"
      ],
      "env": {
        "POLARION_URL": "https://polarion.example.com",
        "POLARION_TOKEN": "your-personal-access-token"
      }
    }
  }
}

工具

未检测到工具

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is Polarion MCP?

Polarion MCP is a Model Context Protocol server for Polarion ALM. It enables AI assistants to read documents, work items, and traceability links, and to create, update, and reorganize work items directly from a Polarion instance.

How to use Polarion MCP?

Requires Polarion 2506 or higher, Python 3.13+, and the uv package manager. Set environment variables POLARION_URL and POLARION_TOKEN, then run via uvx mcp-server-polarion. For Claude Code use claude mcp add; for other clients (VS Code, Claude Desktop, Cursor) add a configuration entry with the same environment variables.

Key features of Polarion MCP

24 tools covering read and write across documents, work items, links, and comments.
Render documents and work items as Markdown for AI consumption.
Search with Lucene queries or SQL via recipes.
Create, update, and manage work items, documents, links, and comments.
Safe writes with dry_run parameter and pre-write validation.
All list tools support pagination (page_size 1–100).

Use cases of Polarion MCP

Discover accessible projects and list documents with their types.
Search for work items using Lucene or SQL, then read and summarize them.
Create work items, link them to existing items, and attach them to documents.
Update work item fields, status, and workflow, or reorganize document structure.
Add and resolve comments on documents to track discussions.

FAQ from Polarion MCP

What Polarion version is required?

Polarion 2506 or higher is required. Earlier versions lack the REST API endpoints this server depends on.

What dependencies are needed to run it?

Requires Python 3.13+ and the uv package manager. The server is distributed as a Python package and runs via uvx, which automatically downloads and executes it.

How is authentication handled?

Authentication uses a Personal Access Token passed via the POLARION_TOKEN environment variable. The Polarion base URL is set in POLARION_URL.

Does the server support write operations safely?

Yes. Every write tool supports a dry_run parameter, and pre-write guards validate fields, enum values, and link targets before sending requests to Polarion.