mcp-server-polarion 是一个为 Polarion ALM 构建的 Model Context Protocol（MCP）服务器。它的目标场景是让兼容 MCP 的 AI 助手直接与真实环境中的 Polarion 交互，读取、写入并重新组织文档、工作项、测试运行和追溯链接。整个服务器围绕生产数据安全性设计：每一次写入都支持 dry_run 预演，写入前的守卫会检查字段与枚举值，请求按用户为实例配置的速率上限节流，使 AI 助手可以在生产数据上操作而不产生意外。
主要能力方面，仓库共提供 46 个工具，覆盖文档、工作项、测试运行、追溯链接、评论和附件的读写。读取能力包括：将文档渲染为 Markdown、使用 Lucene 或 SQL 搜索、遍历传入与传出链接、解析枚举选项。写入能力包括：创建和更新工作项、文档与测试运行，管理链接，重新组织文档结构，发布评论。安全写入方面，每个写入工具都支持 dry_run，写前守卫会校验字段、枚举值和链接目标，之后才提交到 Polarion。该服务器还会与所在服务器友好协作：请求被串行化并按可配置的速率上限节流，对 429/5xx 响应自动重试。此外它面向 LLM 构建：严格异步、完整类型标注、每个列表工具都支持分页，docstring 被编写为供助手阅读的手册。
所有列表工具都支持通过 page_size（1–100）和 page_number 参数进行分页。
使用方式上，该服务器要求 Polarion 2506 或更高版本，更早版本缺少服务器依赖的 REST API 端点。它以 Python 包形式分发，需要 uv 运行。安装 uv 后无需其他安装，uvx mcp-server-polarion 会自动下载并运行服务器。使用时需要配置环境变量，Personal Access Token 的生成方式是：打开 Polarion，点击用户名，进入 My Account → Personal Access Tokens。客户端配置支持多种方式：添加到 .vscode/mcp.json（VS Code）、claude_desktop_config.json（Claude Desktop）、Cursor MCP 设置，或通过 claude mcp add 命令注册（Claude Code 的最快路径）。
示例提示词覆盖了典型使用场景，例如：列出可访问的项目并查看项目 MCPT 中的文档及其类型；列出项目 MCPT 中 space 'Specifications' 下的文档；查找项目 MCPT 中标题以 'Auth' 开头的所有已批准需求并显示其所属文档；搜索项目 MCPT 中自定义字段 'verification_method' 为 'Test' 的工作项（如需 join 可先获取 SQL 配方）；查找项目 MCPT 的 SRS 模块中上个 sprint 变更过的所有工作项；读取项目 MCPT 的 SRS 文档并总结每个未关闭需求；显示 SRS 文档的结构大纲（标题及每个标题下的工作项）；以 Markdown 读取工作项 MCPT-042 并解释其要求；显示 MCPT-042 的传出和传入链接并标记仍处于打开状态的子任务；找出 SRS 文档中没有来自测试用例的 'verifies' 反向链接的需求；列出 SRS 文档上未关闭的评论线程及其发起者；在项目 MCPT 中创建标题为 'Refactor authentication module' 的任务并作为 'relates_to' 链接到 MCPT-042；根据清单在项目 MCPT 中创建三个测试用例工作项并各自作为 'verifies' 链接到 MCPT-042；在 SRS 文档 3.2 节下新增需求；更新 MCPT-042 的描述；在 SRS 文档上添加评论并回复线程将其标记为已解决；从 'Regression' 模板创建测试运行 REG-SPRINT-7；列出项目 MCPT 中缺陷的合法状态值并移动 MCPT-077；调整 MCPT-042 的优先级、严重性并批准工作流；将 MCPT-201 从任务改为需求并恢复原状态；将 MCPT-201 移动到 SRS 文档中 MCPT-150 之后；将 MCPT-077 从文档中分离；将 MCPT-042 到 MCPT-099 的 'blocks' 链接标记为可疑并删除过时的 'relates_to' 链接。
限制与说明：需要 Polarion 2506 或更高版本；需要 uv 运行；需要生成 Personal Access Token 并配置环境变量；使用前需按客户端完成配置。关于收费、价格、平台支持等更多信息，当前资料暂未提供。项目欢迎提交 bug 报告和 pull request，仓库中包含 CONTRIBUTING.md、行为准则和安全政策。
