Mcp Server Polarion

io.github.devemberx由 GitHub 账号 devemberx 发布v2.1.0更新于 Nov 3, 2026

MCP server for Polarion ALM — read and write documents and work items

已验证STDIO仅桌面效率与工作流开发者工具

概览

AI 生成的概览

面向 Polarion ALM 的 MCP 服务器，让助手读取、搜索、创建和更新文档、工作项、测试运行、链接、评论与附件。

可以做什么
  • 列出项目、文档、工作项和测试运行，并用 Lucene 或 SQL 查询，支持分页
  • 以 Markdown 或原始 HTML 读取文档与工作项，查看文档结构、链接、评论和枚举选项
  • 创建和更新工作项、文档与测试运行，包括工作流状态和文档复制
  • 管理追溯链接，将工作项挂载到文档或从文档移除，并调整文档结构
  • 发表和解决评论，上传或查看文档、工作项和测试记录上的附件
适用场景
适合需要助手直接在 Polarion ALM 实例中工作的场景：汇总需求、追踪需求与测试之间的链接、记录测试结果，或起草和重组文档与工作项。
运行要求
需要本地 Python 运行环境与 uv（通过 uvx 运行），以及可访问的 Polarion 2506 或更高版本实例。需设置 POLARION_URL 和 POLARION_TOKEN 环境变量；POLARION_MAX_REQUESTS_PER_SECOND 可选，默认值为 1。
安装前请注意
该服务器会写入生产 ALM 数据：创建和更新工作项、文档与测试运行，删除链接，并把本地文件上传为附件。每个写入工具都支持 dry_run，但需主动启用。它需要 Polarion 个人访问令牌（POLARION_TOKEN），权限等同于令牌所有者，请勿写入共享配置文件。

安装

在 SourceWeft 中

  1. 打开 控制台中的 Mcp Server Polarion，将其添加到工作区。
  2. 为需要使用其工具的对话启用该服务。

Desktop only，通过 STDIO。 STDIO 服务会启动本地进程，因此需要 SourceWeft 桌面宿主。

其他 MCP 客户端

参照 仓库 中的启动说明。

README

[mcp-server-polarion]

mcp-server-polarion

Talk to your Polarion — AI reads, writes, and reorganizes documents, work items, test runs, and traceability links.

Features · Quickstart · Tools · Example Prompts · Setup

[CI] [Publish] [PyPI] [Python 3.13+] [License: MIT]

A Model Context Protocol (MCP) server for Polarion ALM, built for real-world instances: every write supports dry_run, guards validate fields and enum values before anything is committed, and requests are paced to a rate cap you configure for your instance — so an AI assistant can work on production data without surprises.

[mcp-server-polarion demo]

Features

  • 46 tools covering read and write across documents, work items, test runs, traceability links, comments, and attachments.
  • Read — render documents as Markdown, search with Lucene or SQL, walk incoming/outgoing links, resolve enum options.
  • Write — create and update work items, documents, and test runs, manage links, reorganize document structure, post comments.
  • Safe writes — every write tool supports dry_run, and pre-write guards validate fields, enum values, and link targets before hitting Polarion.
  • Plays nice with your server — requests are serialized and paced to a configurable rate cap, with automatic retries on 429/5xx responses.
  • Built for LLMs — strict async, fully typed, pagination on every list tool, docstrings written as the assistant's manual.

Quickstart

Requires Polarion 2506+ and uv — see Prerequisites. Fastest path — Claude Code:

bash
claude mcp add mcp-server-polarion \  -e POLARION_URL=https://polarion.example.com \  -e POLARION_TOKEN=your-personal-access-token \  -- uvx mcp-server-polarion

Other clients (VS Code, Claude Desktop, Cursor) — see Client Configuration.

Tools

Read

ToolDescription
list_projectsList accessible projects
list_documentsList documents in a project
list_work_itemsList work items in a project (Lucene/SQL query)
list_test_runsList test runs in a project (Lucene query, templates filter)
get_test_runGet test run details, optionally with the raw HTML report body
list_test_recordsList a test run's execution records, one per test case iteration
get_test_recordGet one test record's execution comment and test-case revision
get_sql_query_recipesFetch copy-paste SQL recipes for advanced queries
get_html_recipesFetch copy-paste Polarion HTML templates for raw-HTML body edits
get_documentGet document metadata, optionally with the raw body HTML
read_documentRender a document end-to-end as Markdown
read_document_partsList a document's structural parts with embedded work item metadata
get_work_itemGet work item details with the body as raw HTML
read_work_itemGet work item details with the body as Markdown
list_work_item_linksList a work item's outgoing or incoming links
list_document_attachmentsList a document's attachments with file name, size, and author
get_document_attachment_contentFetch an image attachment for viewing (bitmap as image, SVG as text)
list_work_item_attachmentsList a work item's attachments with file name, size, and author
get_work_item_attachment_contentFetch a work item image attachment for viewing (bitmap as image, SVG as text)
list_test_record_attachmentsList a test record's attachments with file name, size, and author
get_test_record_attachment_contentFetch a test record image attachment for viewing (bitmap as image, SVG as text)
list_document_commentsList a document's comments with thread relationships
list_work_item_commentsList a work item's comments with thread relationships
list_document_enum_optionsResolve valid enum ids for a document field
list_work_item_enum_optionsResolve valid enum ids for a work item field

All list tools support pagination via page_size (1–100) and page_number parameters.

Write

ToolDescription
create_work_itemsCreate one or more work items in a single request
update_work_itemsUpdate fields, body, or workflow status on one or more work items
create_documentCreate a new document
update_documentUpdate document metadata, body, or workflow status
copy_documentCopy a document to a new name, space, or project
create_test_runsCreate one or more test runs, optionally from a template
create_test_recordsRecord test-case execution results on a test run
update_test_runsUpdate title, status, group, or custom fields on one or more test runs
update_test_recordsUpdate result, comment, or defect link on one or more test records of a test run
create_work_item_linksCreate one or more outgoing links from a source work item
update_work_item_linkUpdate suspect / revision on one outgoing link
delete_work_item_linksDelete one or more outgoing links from a source work item
move_work_item_to_documentAttach a work item to a document at a chosen position
move_work_item_from_documentDetach a work item from its document
create_document_attachmentsUpload one or more local files as document attachments
create_work_item_attachmentsUpload one or more local files as work item attachments
create_test_record_attachmentsUpload one or more local files as test record attachments
create_document_commentsAdd one or more comments or replies to a document
create_work_item_commentsAdd one or more comments or replies to a work item
update_document_commentResolve or re-open a document comment
update_work_item_commentResolve or re-open a work item comment

Example Prompts

Discovery & search

"List the projects I can access, then show the documents in project MCPT with their types."

"List the documents in space 'Specifications' of project MCPT."

"Find every approved requirement in project MCPT whose title starts with 'Auth' and show me their owning document."

"Search project MCPT for work items where the custom field 'verification_method' is 'Test' — grab the SQL recipes first if you need a join."

"Find all work items in the SRS module of project MCPT that were changed in the last sprint."

Reading & summarizing

"Read the SRS document of project MCPT and summarize each open requirement."

"Show me the structural outline of the SRS document — headings and the work items under each."

"Read work item MCPT-042 as Markdown and explain what it asks for."

"Show the outgoing and incoming links for MCPT-042 and flag any child task that is still open."

"Which requirements in the SRS document have no 'verifies' back link from a test case?"

"List the open comment threads on the SRS document and who started each."

Creating & editing

"Create a task in project MCPT titled 'Refactor authentication module' and link it to MCPT-042 as 'relates_to'."

"Create three test-case work items in project MCPT from this checklist and link each one to MCPT-042 as 'verifies'."

"Add a new requirement under section 3.2 of the SRS document with the body I just drafted."

"Update the description of MCPT-042 with the revised text I'll paste, keeping the existing formatting."

"Add a comment on the SRS document asking the owner to clarify section 4, then reply to thread T-12 marking it resolved."

"Create a test run REG-SPRINT-7 in project MCPT from the 'Regression' template with status 'open'."

Workflow & reorganization

"List the valid status values for a defect in project MCPT, then move MCPT-077 to 'in_review'."

"Bump MCPT-042's priority to 90, set severity to 'major', and approve the workflow."

"Change MCPT-201 from a task to a requirement and re-apply its previous status."

"Move MCPT-201 into the SRS document right after MCPT-150."

"Detach MCPT-077 from its document so I can rework it as a standalone task."

"Mark the 'blocks' link from MCPT-042 to MCPT-099 as suspect, then delete the stale 'relates_to' link to MCPT-010."

Setup

Prerequisites

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

This server is distributed as a Python package and requires uv to run.

Install uv (if not already installed):

bash
# macOS / Linuxcurl -LsSf https://astral.sh/uv/install.sh | sh
# Windowspowershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

Or via pip:

bash
pip install uv

No other installation is needed — uvx mcp-server-polarion downloads and runs the server automatically.

Environment Variables

VariableDescriptionExample
POLARION_URLBase URL of your Polarion instancehttps://polarion.example.com
POLARION_TOKENPersonal Access Token for authenticationyour-personal-access-token
POLARION_MAX_REQUESTS_PER_SECONDOptional. Client-side request rate cap — raise it to match your deployment's throttle, or set 0 to disable pacing. Writes keep a fixed extra pause regardless (default: 1)1

To generate a Personal Access Token, open Polarion, click your user name, and go to My Account → Personal Access Tokens.

Client Configuration

VS Code (GitHub Copilot)

Add to .vscode/mcp.json:

json
{  "servers": {    "mcp-server-polarion": {      "type": "stdio",      "command": "uvx",      "args": ["mcp-server-polarion"],      "env": {        "POLARION_URL": "https://polarion.example.com",        "POLARION_TOKEN": "your-personal-access-token"      }    }  }}
Claude Desktop

Add to claude_desktop_config.json:

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

Add to Cursor MCP settings:

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

Register via the claude mcp add command:

bash
claude mcp add mcp-server-polarion \  -e POLARION_URL=https://polarion.example.com \  -e POLARION_TOKEN=your-personal-access-token \  -- uvx mcp-server-polarion

Contributing

Bug reports and pull requests are welcome — see CONTRIBUTING.md for branch, commit, and review conventions.

License

MIT

来源：README.md，提交 09d056e

工具

0
SourceWeft 尚未在沙箱中启动过该软件包，因此其工具未知。

版本历史

1
  1. v2.1.0最新Sep 16, 2026

评分

已满足适用检查项的 50%

该评分衡量此收录条目的完整程度，依据注册中心条目、端点与公开来源计算得出。它不是对服务器本身的评价，也不表示服务器安全或当前可用：可连通性是带日期的检查结果，评分也不包含安装量或用户评价。

  • 近 30 天内可连通25 分

    请保持端点能够响应 MCP 握手；SourceWeft 每 30 天探测一次。

  • 已声明认证方式10 分

    请在注册中心条目中声明凭据请求头，或保持端点能够响应探测，以便判定其认证方式。

  • 已列出工具15 分

    请让服务器在无凭据时响应 tools/list，或发布可在沙箱中无凭据启动的软件包。

  • 描述必需15 分
  • 图标10 分
  • 文档15 分
  • 许可证10 分