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.