Polarionmcpservers

🚀 Polarion トラブルシューティングプロトコル (MCP) サーバー

このリポジトリには、Polarion アプリケーションライフサイクル管理 (ALM) 統合に適した Model Context Protocol (MCP) サーバーの実装が含まれています。

MCP ツールは、Polarion ワークアイテムに使用でき、以下の操作が可能です。

• Polarion ワークアイテムの読み取り

✨ 主な機能

プロジェクト

• PolarionRemoteMcpServer：SSE ベースの MCP サーバーで、サーバー側のインストールに適しています。
• PolarionMcpServer：コンソールベースの MCP サーバーで、Polarion ワークステーションの統合に適しています。

📦 インストール

Docker と Linux サーバーを使用した実行（推奨）

1. Linux サーバー上で、設定とログのディレクトリを作成します。

   mkdir -p /opt/polarion-mcp-server
   cd /opt/polarion-mcp-server
   

2. Docker イメージを取得します。

   docker pull tizzolicious/polarion-remote-mcp-server
   

3. カスタムの /opt/polarion-mcp-server/appsettings.json ファイルを作成し、Polarion の設定に合わせて調整します。

   {
     "Logging": {
       "LogLevel": {
         "Default": "Information",
         "Microsoft.AspNetCore": "Warning"
       }
     },
     "AllowedHosts": "*",
     "PolarionClientConfiguration": {
       "ServerUrl": "https://your-polarion-server/",
       "Username": "your-username",
       "Password": "your-password",
       "ProjectId": "your-project-id",
       "TimeoutSeconds": 60
     }
   }
   

4. Docker コンテナを実行します。

   docker run -d \
     --name polarion-mcp-server \
     -p 8080:8080 \
     -v appsettings.json:/app/appsettings.json \
     tizzolicious/polarion-remote-mcp-server
   

5. これでサーバーが起動し、http://{{your-server-ip}}:5090/sse からアクセスできます。

設定オプション

PolarionClientConfiguration ノード内の /opt/polarion-mcp-server/appsettings.json ファイルには、以下の設定が必要です。

💻 使用例

MCP クライアントの設定

Cline での設定

1. Cline の MCP 設定 UI を開きます。
2. 「リモートサーバー」タブをクリックします。
3. 「サーバー名」を「Polarion」に設定します。
4. 「サーバー URL」を「http://{{your-server-ip}}:5090/sse」に設定します。
5. 「サーバーを追加」をクリックします。

Visual Studio Code での設定

settings.json ファイルに以下の設定を追加します。

"servers": {
    "polarion-remote": {
        "type": "sse",
        "url": "ttp://{{your-server-ip}}:8080/sse",
        "env": {}
    }
}

Claude Desktop での設定

1. Claude の「設定」メニューを開きます。
2. 「プロジェクト設定」を選択します。
3. 新しい「リモートサーバー」を追加します。
   • タイプを「MCP」に設定します。
   • URL を「http://{{your-server-ip}}:8080/sse」に設定します。

🔧 技術詳細

プロジェクトのビルド

要件

• .NET SDK バージョン 6 以上
• システムに Docker がインストールされていること

ビルド方法

1. このリポジトリをローカルマシンにクローンします。
2. ターミナルを開き、クローンしたディレクトリに移動します。
3. 以下のコマンドを実行してプロジェクトをビルドします。

   dotnet build
   

公開方法

1. ターミナルで以下のコマンドを実行して Docker イメージを生成します。

   docker-compose build
   

2. サーバーを実行するには、以下のコマンドを実行します。

   docker-compose up
   

これらの手順に従えば、Polarion MCP サーバーを正常に設定して実行できるはずです。