Back to MCP directory
publicPublicdnsLocal runtime

PolarionMcpServers

该项目提供与Polarion ALM系统集成的MCP服务器实现,支持通过Docker部署和本地运行,实现工作项读取等功能。

article

README

🚀 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 访问它。

配置选项

| 属性 | 详情 | |------|------| | ServerUrl | 你的 Polarion 服务器 URL(例如,"https://polarion.example.com/") | | Username | 具有适当权限的 Polarion 用户名 | | Password | Polarion 用户的密码 | | ProjectId | 要访问的 Polarion 项目 ID | | TimeoutSeconds | 连接超时时间(单位:秒,默认为 60) |

配置 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
  1. 要运行服务器,执行以下命令:
docker-compose up

通过遵循以上步骤,你应该能够成功设置和运行 Polarion MCP 服务器。

help

Runtime guide

cloud

Hosted runtime

Hosted servers run from a provider-managed environment. You usually connect the MCP client to the hosted endpoint or follow the provider's authorization flow, without keeping a local process alive

  1. Open provider connection page
  2. Authorize or copy endpoint
  3. Connect from your MCP client
terminal

Local runtime / other methods

Local servers run on your own machine or infrastructure. You normally copy the server_config into your MCP client, install the required package, and provide env variables from env_schema when needed

  1. Copy server_config
  2. Install required package
  3. Fill env variables and restart client