README
🚀 Polarion 麻烦解决协议 (MCP) 服务器
本仓库提供了适用于 Polarion 应用生命周期管理 (ALM) 集成的 Model Context Protocol (MCP) 服务器实现。MCP 工具可用于处理 Polarion 工作项,主要功能为读取 Polarion 工作项。
✨ 主要特性
- 项目类型丰富:
- PolarionRemoteMcpServer:基于 SSE 的 MCP 服务器,适合服务器端安装。
- PolarionMcpServer:控制台基于的 MCP 服务器,便于与 Polarion 工作站集成。
🚀 快速开始
📦 安装指南
通过 Docker 和 Linux 服务器运行(推荐)
- 在你的 Linux 服务器上,创建一个配置和日志目录:
mkdir -p /opt/polarion-mcp-server cd /opt/polarion-mcp-server - 拉取 Docker 镜像:
docker pull tizzolicious/polarion-remote-mcp-server - 创建一个自定义的
/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 } } - 运行 Docker 容器:
docker run -d \ --name polarion-mcp-server \ -p 8080:8080 \ -v appsettings.json:/app/appsettings.json \ tizzolicious/polarion-remote-mcp-server - 现在服务器应该已经启动运行。你可以通过
http://{{your-server-ip}}:5090/sse访问它。
配置选项
| 属性 | 详情 | |------|------| | ServerUrl | 你的 Polarion 服务器 URL(例如,"https://polarion.example.com/") | | Username | 具有适当权限的 Polarion 用户名 | | Password | Polarion 用户的密码 | | ProjectId | 要访问的 Polarion 项目 ID | | TimeoutSeconds | 连接超时时间(单位:秒,默认为 60) |
配置 MCP 客户端
要在 Cline 中配置:
- 打开 Cline 的 MCP 设置 UI。
- 点击“远程服务器”选项卡。
- 将“服务器名称”设置为“Polarion”。
- 将“服务器 URL”设置为“http://{{your-server-ip}}:5090/sse”。
- 点击“添加服务器”。
要在 Visual Studio Code 中配置:
在你的 settings.json 文件中添加以下配置:
"servers": {
"polarion-remote": {
"type": "sse",
"url": "ttp://{{your-server-ip}}:8080/sse",
"env": {}
}
}
要在 Claude Desktop 中配置:
- 打开 Claude 的“设置”菜单。
- 选择“项目设置”。
- 添加一个新的“远程服务器”:
- 设置类型为“MCP”。
- 设置 URL 为“http://{{your-server-ip}}:8080/sse”。
构建项目
要求
- .NET SDK 版本 6 或更高。
- Docker 安装在你的系统上。
如何构建
- 克隆此仓库到你的本地机器。
- 打开终端,导航到克隆目录。
- 运行以下命令来构建项目:
dotnet build
如何发布
- 在终端中运行以下命令以生成 Docker 镜像:
docker-compose build
- 要运行服务器,执行以下命令:
docker-compose up
通过遵循以上步骤,你应该能够成功设置和运行 Polarion MCP 服务器。
Scan to contact