并排MCP服务器
太长，读不下去了
这 并排MCP服务器 使基于IDE的AI代理能够安全地 阅读Jira门票, 应用代码更改, 验证它们 根据QA标准， 评论结果 回到Jira，并自动 转换票 审查。这个自动化循环是通过模型上下文协议（MCP）和Docker安全管理的，无论您的本地环境如何，都能确保一致的执行。
这解决了什么问题？
开发不仅仅涉及编写代码；它需要理解上下文、执行任务、验证结果和更新项目跟踪器。手动将您的工作与Jira同步会打断流程并引入摩擦。 该工具通过允许您的AI代理执行以下操作来弥合差距：
- 理解上下文：直接阅读工单描述、目标和QA要求。
- 执行并验证：检测“运行MCP”触发器以开始工作，并根据定义的目标进行自我验证。
- 同步状态：自动更新Jira状态并对进度留下详细评论。
工作流程
- 代理连接到Jira：代理会验证并检索您分配的票证。
- 门票已加载到会话中：会话的活动票证已缓存。
- 解析票证描述：系统会查找目标和触发器等特定标签。
- 检测到运行MCP触发器：如果找到，则会提醒代理任务已准备好执行。
- 代理执行任务：代理读取代码，实现更改并验证它们。
- QA部分已验证：代理人核对工作是否符合要求
QA门票中的标准。 - 评论已添加到Jira：工作报告（以及任何验证证明）作为评论发布。
- 门票转换为审核中：最后，票证将移动到“审核中”状态。
什么是并排？
并排 是一个可选的身份验证和功能层，可以与此MCP服务器一起使用，以提供增强的会话管理或特定的企业集成功能。
配置
要使用此服务器，您必须提供配置参数。
最低配置（必需）
这4个变量是开始所需的最小值：
JIRA_URL=https://your-domain.atlassian.net
JIRA_AUTH=YOUR_BASE64_AUTH
SIDE_BY_SIDE_PROJECT=SBS
SIDE_BY_SIDE_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx
SIDEBYSIDE_EMAIL=your-email@test.com
SIDEBYSIDE_UUID=xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx完整配置参考
其余变量自定义工作流行为、状态处理和并排集成。
| 参数 | 类型 | 必填 | 说明 |
|---|---|---|---|
JIRA_URL | URL | 是 | JIRA实例的基本URL（例如。， https://your-domain.atlassian.net). |
JIRA_AUTH | 字符串 | 是 | Base64编码 username:api_token. |
SIDE_BY_SIDE_PROJECT | 字符串 | 是 | Jira项目密钥前缀（例如。， SBS)限制门票入场。 |
SIDE_BY_SIDE_KEY | UUID | 是 | Side-by-Side集成的有效UUID密钥。 |
JIRA_CURRENT_DEV_USER | String | No | 当前开发者的显示名称（例如。， Dev2-AI). |
JIRA_TICKET_PREVIOUS_STATUS | String | No | 查找以前票证的状态（例如。， Analysis). |
JIRA_TICKET_STATUS_PROGRESS | String | No | 正在处理的票的状态（例如。， In Progress). |
JIRA_TICKET_STATUS_REVIEW | 字符串 | 否 | 标识正在审核的票证的状态（例如。， In Review). |
JIRA_TICKET_STATUS_BLOCK | String | No | 被阻止的票的状态（例如。， Block). |
JIRA_TICKET_TRANSITION_NOT_ALLOWED | 字符串 | 否 | 标识不允许转换的票证的状态（例如。， Done). |
SIDEBYSIDE_URL | URL | 否 | 并排登录的URL。 |
SIDEBYSIDE_EMAIL | 字符串 | 是 | 用于并排登录的电子邮件。 |
SIDEBYSIDE_UUID | 字符串 | 是 | 并排登录的UUID。 |
SIDEBYSIDE_MCP_GOAL_TAG | 字符串 | 否 | 标识目标部分的标签（默认 Goal:). |
SIDEBYSIDE_MCPRUN_GOAL_TAG | 字符串 | 否 | 标识触发动作的标签（默认 ` |
| RUN MCP`). | |||
SIDEBYSIDE_MCPRUN_TRIGGER | 布尔 | 否 | 启用/禁用触发器解析（默认 true). |
如何生成JIRA_AUTH
- 对您的凭据进行编码：
echo -n "email@example.com:your_api_token" | base64- 将输出字符串用作
JIRA_AUTH.
看 大西洋API代币 用于生成您的令牌。
使用Docker运行（必填）
此MCP服务器设计为作为Docker容器运行，以确保环境一致性。
1.运行容器
以名称开始容器 sidebyside。这将创建一个长时间运行的实例，IDE将对其执行命令。
docker run -d \
--name sidebyside \
leonmex/mcp-side-by-side:v1.0.1_注意：在实际的生产或持久设置中，如果你想将环境变量烘焙到容器会话中，你可以在这里传递它们，但通常对于MCP，我们通过 docker exec 客户端配置中的命令。_
2.验证它是否正在运行
检查容器的状态：
docker ps --filter "name=sidebyside"3.测试内部流程（可选）
您可以通过直接运行节点进程来查看其启动情况，从而验证映像是否正常工作：
docker exec -it sidebyside node dist/index.js输出：
MCP JIRA Side-by-Side Server running on stdio
Loaded Configuration Project: ...使用VS代码/反重力设置
此配置假定MCP服务器已在名为的Docker容器中运行 sidebyside （如上所述）。
将此添加到您的 mcpServers 配置：
{
"mcpServers": {
"side-by-side-mcp": {
"command": "docker",
"args": [
"exec", // Execute a command in a running container
"-i", // Interactive mode (keep stdin open)
"-e",
"JIRA_URL=https://your-domain.atlassian.net",
"-e",
"JIRA_AUTH=YOUR_BASE64_AUTH",
"-e",
"SIDE_BY_SIDE_PROJECT=SBS",
"-e",
"SIDE_BY_SIDE_KEY=xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx",
// ... (Add other optional variables as needed)
"sidebyside", // The container name
"node",
"dist/index.js" // The command to run inside the container
]
}
}
}为什么 docker exec? 我们使用 docker exec 在现有流程中运行新流程 sidebyside 为每个MCP连接注入特定的环境变量。
可用工具
connect-with-jira-client：使用配置的凭据连接到Jira客户端并检索帐户ID。get-session-tickets：检索当前存储在会话中的Jira票证列表。jira-verify-connection：验证Jira连接是否有效。refresh-tickets-information：从Jira刷新票证信息。jira-update-ticket-status：更改状态（例如。，issueKey=SBS-123,targetStatus=In Progress).jira-add-comment：向Jira票证添加注释（例如演练结果）。
使用指南
Jira票证的触发操作
为了自动化工作，请有效地构建Jira票证描述。
检测与行为
当时 refresh-tickets-information 工具运行时，它会解析票证。如果它发现 运行MCP 标签，它标记了票。
- 视觉指示器:
🚨 TRIGGERED 🚨: READY TO START PROCESS - 信号：这张票告诉告诉“这张票已经准备好让你工作了。”
具体例子
以下是一个结构良好的Jira票证描述应该是什么样子的：
说明： 我们需要更新登录页面，以包含“忘记密码”链接。目前，如果用户丢失了凭据，他们就会陷入困境。 目标：
Add "Forgot Password" link below the login button
Ensure it redirects to /recover-password
RUN MCP
质量保证： 1. 验证链接是否出现在登录页面上。 1. 单击链接并验证它是否转到恢复页面。
_注： RUN MCP 目标列表中是触发自动化的因素。_
门票最佳实践
为了减轻幻觉并提高质量，请始终包括：
- 描述：上下文 _为什么_ 和 _什么_ （当前状态与期望状态）。
- 目标：明确的成功标准。使用
Goal:标签。 - 问答：验证步骤。这有助于代理人自我纠正。
故障模式和保护措施
- 状态转换失败：如果代理试图将工单移动到不允许的状态（例如严格的工作流规则），该工具将返回一条错误消息，解释有效的转换。
- 缺少QA：如果缺少QA部分，代理可能不知道如何验证其工作。最好的做法是始终包含它们。
- 连接问题：如果
jira-verify-connection失败，请检查您的JIRA_AUTH和JIRA_URL.确保Docker容器可以访问互联网。
谁应该使用这个？
此MCP服务器非常适合以下团队：
- 使用 Jira 作为发展任务的真理来源。
- 跑 AI代理 IDE内部（如VS Code或Antigravity）。
- 想要 受控、可审计的自动化 他们的开发工作流程。
- 要求执行任务 状态转换 和 评论 作为完成定义的一部分。