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