mcpField
P
Polarion MCP

Polarion MCP

ローカル
github.com/devemberx開発ツール171 週間前に更新

Polarion MCP について

Polarion MCPは、Polarion ALMを扱うAIアシスタント向けのMCPサーバーです。ドキュメント、作業項目、テスト実行、トレーサビリティリンクを読み書きでき、書き込み前の検証とdry_runに対応します。

主な機能

  1. 01ドキュメントと作業項目の読み取り・検索
  2. 02テスト実行と記録の作成・更新
  3. 03トレーサビリティリンク、コメント、添付ファイルの管理
  4. 04書き込みの事前検証とdry_run
  5. 05リクエストの調整と自動リトライ

活用シーン

  1. 01要件を検索して関連ドキュメントを確認
  2. 02作業項目を更新してワークフロー状態を変更
  3. 03テスト結果を記録し検証リンクを管理
  4. 04ドキュメント構成を整理してコメントに対応

MCP 対応

MCPサーバーは、Polarionのドキュメント、作業項目、テスト実行、トレーサビリティリンク、コメント、添付ファイルを読み書きするツールを提供します。Polarion 2506以降に接続します。

設定

ローカルサーバーの設定はどのクライアントでも共通です。コピーしてクライアントの MCP 設定ファイルに貼り付けてください。

mcp.json · 共通設定
{
"mcpServers": {
"polarion": {
"command": "uvx",
"args": [
"mcp-server-polarion"
],
"env": {
"POLARION_URL": "<POLARION_URL>",
"POLARION_TOKEN": "<POLARION_TOKEN>",
"POLARION_MAX_REQUESTS_PER_SECOND": "<POLARION_MAX_REQUESTS_PER_SECOND>"
}
}
}
}
起動コマンドuvx mcp-server-polarion
設定が必要な環境変数
POLARION_URLBase URL of the Polarion server
POLARION_TOKENシークレットPolarion personal access token
POLARION_MAX_REQUESTS_PER_SECONDClient-side request rate cap in requests per second; match your deployment's throttle. 0 disables pacing (default: 1)

ローカルサーバーにはマシン上の実行環境(Node.js 18 以上など)が必要です。設定ファイルの場所はクライアントごとに異なります。

パッケージ
pypimcp-server-polarion2.1.0

ツール

46

掲載時のツール一覧 · 2 週間前に更新

パラメーター型必須説明
project_idstringはいPolarion プロジェクト ID。
space_idstringはいスペース ID(「_default」= デフォルトスペース)。
document_namestringはいspace_id 内のドキュメント名。
page_sizeintegerいいえ
page_numberintegerいいえ

詳細

mcp-server-polarion

mcp-server-polarion

Polarion と対話できます。AI がドキュメント、作業項目、テスト実行、トレーサビリティリンクを読み取り、書き込み、再編成します。

機能 · クイックスタート · ツール · プロンプト例 · セットアップ

CI Publish PyPI Python 3.13+ License: MIT

Model Context Protocol(MCP)に対応するPolarion ALM向けサーバーです。実運用のインスタンスを想定しており、すべての書き込みでdry_runを利用できます。変更を確定する前にガードがフィールドと列挙値を検証し、リクエストはインスタンスに合わせて設定したレート上限に従って送信されるため、AI アシスタントが予期せぬ事態を招くことなく本番データを操作できます。

mcp-server-polarion のデモ

機能

  • 46 個のツールで、ドキュメント、作業項目、テスト実行、トレーサビリティリンク、コメント、添付ファイルの読み取りと書き込みに対応します。
  • 読み取り — ドキュメントを Markdown としてレンダリングし、Lucene または SQL で検索し、受信/送信リンクをたどり、列挙型の選択肢を解決します。
  • 書き込み — 作業項目、ドキュメント、テスト実行の作成と更新、リンクの管理、ドキュメント構造の再編成、コメントの投稿ができます。
  • 安全な書き込み — すべての書き込みツールでdry_runを利用でき、Polarion に変更を加える前に、事前書き込みガードがフィールド、列挙値、リンク先を検証します。
  • サーバーと円滑に連携 — リクエストは直列化され、設定可能なレート上限に従って送信されます。429/5xx 応答があった場合は自動的に再試行します。
  • LLM 向けに設計 — 厳密な非同期処理と完全な型付けを採用し、すべての一覧表示ツールでページネーションに対応しています。docstring はアシスタント向けのマニュアルとして記述されています。

クイックスタート

Polarion 2506 以降とuvが必要です。詳しくは前提条件をご覧ください。最も手早く始めるには、Claude Code を使用します。

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

その他のクライアント(VS Code、Claude Desktop、Cursor)については、クライアントの設定をご覧ください。

ツール

読み取り
ツール説明
list_projectsアクセス可能なプロジェクトを一覧表示します
list_documentsプロジェクト内のドキュメントを一覧表示します
list_work_itemsプロジェクト内の作業項目を一覧表示します(Lucene/SQL クエリ)
list_test_runsプロジェクト内のテスト実行を一覧表示します(Lucene クエリ、テンプレートによるフィルタリング)
get_test_runテスト実行の詳細を取得します。オプションで生の HTML レポート本文も取得できます
list_test_recordsテスト実行の実行記録を一覧表示します。テストケースの各反復につき 1 件です
get_test_record1 件のテスト記録の実行コメントとテストケースのリビジョンを取得します
get_sql_query_recipes高度なクエリ用のコピー&ペースト可能な SQL レシピを取得します
get_html_recipes生の HTML 本文を編集するためのコピー&ペースト可能な Polarion HTML テンプレートを取得します
get_documentドキュメントのメタデータを取得します。オプションで生の本文 HTML も取得できます
read_documentドキュメント全体を Markdown としてレンダリングします
read_document_parts埋め込みの作業項目メタデータとともに、ドキュメントの構造部分を一覧表示します
get_work_item本文を生の HTML として、作業項目の詳細を取得します
read_work_item本文を Markdown として、作業項目の詳細を取得します
list_work_item_links作業項目の発信リンクまたは着信リンクを一覧表示します
list_document_attachmentsファイル名、サイズ、作成者とともに、ドキュメントの添付ファイルを一覧表示します
get_document_attachment_content表示用に画像の添付ファイルを取得します(ビットマップは画像、SVG はテキストとして取得)
list_work_item_attachmentsファイル名、サイズ、作成者とともに、作業項目の添付ファイルを一覧表示します
get_work_item_attachment_content表示用に作業項目の画像添付ファイルを取得します(ビットマップは画像、SVG はテキストとして取得)
list_test_record_attachmentsファイル名、サイズ、作成者とともに、テスト記録の添付ファイルを一覧表示します
get_test_record_attachment_content表示用にテスト記録の画像添付ファイルを取得します(ビットマップは画像、SVG はテキストとして取得)
list_document_commentsスレッドの関連情報とともに、ドキュメントのコメントを一覧表示します
list_work_item_commentsスレッドの関連情報とともに、作業項目のコメントを一覧表示します
list_document_enum_optionsドキュメントのフィールドで有効な列挙型 ID を解決します
list_work_item_enum_options作業項目のフィールドで有効な列挙型 ID を解決します

すべての一覧表示ツールは、page_size(1~100)および page_number パラメーターによるページネーションに対応しています。

書き込み
ツール説明
create_work_items1 回のリクエストで 1 件以上の作業項目を作成します
update_work_items1 件以上の作業項目のフィールド、本文、またはワークフローのステータスを更新します
create_document新しいドキュメントを作成します
update_documentドキュメントのメタデータ、本文、またはワークフローのステータスを更新します
copy_documentドキュメントを新しい名前、スペース、またはプロジェクトにコピーします
create_test_runsテンプレートを使用するかどうかを指定して、1 件以上のテスト実行を作成します
create_test_recordsテスト実行にテストケースの実行結果を記録します
update_test_runs1 件以上のテスト実行のタイトル、ステータス、グループ、またはカスタムフィールドを更新します
update_test_recordsテスト実行の 1 件以上のテスト記録について、結果、コメント、または不具合へのリンクを更新します
create_work_item_linksソースの作業項目から 1 件以上の発信リンクを作成します
update_work_item_link1 件の発信リンクの suspect / revision を更新します
delete_work_item_linksソースの作業項目から 1 件以上の発信リンクを削除します
move_work_item_to_document指定した位置に作業項目をドキュメントへ添付します
move_work_item_from_document作業項目をドキュメントから切り離します
create_document_attachments1 件以上のローカルファイルをドキュメントの添付ファイルとしてアップロードします
create_work_item_attachments1 件以上のローカルファイルを作業項目の添付ファイルとしてアップロードします
create_test_record_attachments1 件以上のローカルファイルをテスト記録の添付ファイルとしてアップロードします
create_document_commentsドキュメントに 1 件以上のコメントまたは返信を追加します
create_work_item_comments作業項目に 1 件以上のコメントまたは返信を追加します
update_document_commentドキュメントのコメントを解決済みにするか、再度開きます
update_work_item_comment作業項目のコメントを解決済みにするか、再度開きます

プロンプトの例

探索と検索

「アクセスできるプロジェクトを一覧表示してから、プロジェクト MCPT のドキュメントを種類とともに表示してください。」

「プロジェクト MCPT のスペース『Specifications』にあるドキュメントを一覧表示してください。」

「プロジェクト MCPT で、タイトルが『Auth』で始まる承認済みの要件をすべて検索し、それぞれの所有ドキュメントを表示してください。」

「プロジェクト MCPT で、カスタムフィールド『verification_method』が『Test』の作業項目を検索してください。結合が必要な場合は、まず SQL のレシピを取得してください。」

「プロジェクト MCPT の SRS モジュールで、直近のスプリント中に変更された作業項目をすべて検索してください。」

読み取りと要約

「プロジェクト MCPT の SRS ドキュメントを読み、未完了の各要件を要約してください。」

「SRS ドキュメントの構成を、見出しと各見出しの下にある作業項目とともに表示してください。」

「作業項目 MCPT-042 を Markdown として表示し、要求内容を説明してください。」

「MCPT-042 の発信リンクと着信リンクを表示し、未完了の子タスクがあれば示してください。」

「SRS ドキュメント内で、テストケースから『verifies』のバックリンクがない要件はどれですか?」

「SRS ドキュメントの未解決のコメントスレッドを一覧表示し、それぞれの開始者を示してください。」

作成と編集

「プロジェクト MCPT に『Refactor authentication module』というタイトルのタスクを作成し、MCPT-042 に『relates_to』としてリンクしてください。」

「このチェックリストから、プロジェクト MCPT にテストケースの作業項目を3つ作成し、それぞれを MCPT-042 に『verifies』としてリンクしてください。」

「先ほど作成した本文を使って、SRS ドキュメントのセクション 3.2 の下に新しい要件を追加してください。」

「貼り付ける改訂版のテキストで MCPT-042 の説明を更新し、既存の書式を維持してください。」

「SRS ドキュメントに、セクション 4 の説明を求めるコメントを追加してから、スレッド T-12 に返信し、解決済みとしてマークしてください。」

「『Regression』テンプレートから、ステータス『open』のテスト実行 REG-SPRINT-7 をプロジェクト MCPT に作成してください。」

ワークフローと再編成

「プロジェクト MCPT の不具合に有効なステータス値を一覧表示してから、MCPT-077 を『in_review』に移してください。」

「MCPT-042 の優先度を 90 に上げ、重大度を『major』に設定して、ワークフローを承認してください。」

「MCPT-201 をタスクから要件に変更し、以前のステータスを再適用してください。」

「MCPT-201 を SRS ドキュメント内の MCPT-150 の直後に移してください。」

「MCPT-077 をドキュメントから切り離し、単独のタスクとして作業できるようにしてください。」

「MCPT-042 から MCPT-099 への『blocks』リンクを要確認としてマークし、古い MCPT-010 への『relates_to』リンクを削除してください。」

セットアップ

前提条件

Polarion 2506 以降が必要です。それ以前のバージョンには、このサーバーが依存する REST API エンドポイントがありません。

このサーバーは Python パッケージとして配布されており、実行には uv が必要です。

uv をインストール(まだインストールされていない場合):

# macOS / Linux
curl -LsSf https://astral.sh/uv/install.sh | sh

# Windows
powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex"

または pip を使用:

pip install uv

ほかにインストールするものはありません。uvx mcp-server-polarion を実行すると、サーバーが自動的にダウンロードされて起動します。

環境変数
変数説明例
POLARION_URLPolarion インスタンスのベース URLhttps://polarion.example.com
POLARION_TOKEN認証用のパーソナルアクセストークンyour-personal-access-token
POLARION_MAX_REQUESTS_PER_SECOND任意。クライアント側のリクエストレート上限です。デプロイ環境のスロットリングに合わせて値を上げるか、ペーシングを無効にするには 0 を設定します。書き込みには、これとは別に一定の追加待機時間が適用されます(デフォルト:1)1

パーソナルアクセストークンを生成するには、Polarion を開き、ユーザー名をクリックして、My Account → Personal Access Tokens に移動してください。

クライアント設定
VS Code(GitHub Copilot)

.vscode/mcp.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

claude_desktop_config.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

Cursor の MCP 設定に追加します:

{
  "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

claude mcp add コマンドで登録します:

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.md をご覧ください。

ライセンス

MIT

コメント

MCP は初めてですか?

プロトコルの概要から最初のサーバーの導入まで、よくある疑問にまとめて答えます。

AI アプリケーションが外部のツールやデータソースに統一的な方法で接続するためのオープンなプロトコルです。クライアントはモデルとの対話を担い、MCP サーバーはツール・リソース・プロンプトテンプレートを提供します。標準メッセージでやり取りするため、1 つのサーバーを複数のクライアントで再利用できます。