Polarionmcpservers

🚀 Polarion 麻煩解決協議 (MCP) 服務器

本項目提供了適用於 Polarion 應用生命週期管理 (ALM) 集成的 Model Context Protocol (MCP) 服務器實現。MCP 工具可對 Polarion 工作項進行操作，如讀取工作項信息，為 Polarion 的使用提供了便利。

✨ 主要特性

• 多類型服務器實現：包含基於 SSE 的 PolarionRemoteMcpServer 服務器，適用於服務器端安裝；以及控制檯基於的 PolarionMcpServer 服務器，適用於 Polarion 工作站集成。
• 支持多種操作：可用於讀取 Polarion 工作項。

📦 安裝指南

通過 Docker 和 Linux 服務器運行（推薦）

1. 創建配置和日誌目錄：

   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 服務器。