MCP Side By Side

并排MCP服务器

太长，读不下去了

这 并排MCP服务器 使基于IDE的AI代理能够安全地 阅读Jira门票, 应用代码更改, 验证它们 根据QA标准， 评论结果 回到Jira，并自动 转换票 审查。这个自动化循环是通过模型上下文协议（MCP）和Docker安全管理的，无论您的本地环境如何，都能确保一致的执行。

这解决了什么问题？

开发不仅仅涉及编写代码；它需要理解上下文、执行任务、验证结果和更新项目跟踪器。手动将您的工作与Jira同步会打断流程并引入摩擦。 该工具通过允许您的AI代理执行以下操作来弥合差距：

• 理解上下文：直接阅读工单描述、目标和QA要求。
• 执行并验证：检测“运行MCP”触发器以开始工作，并根据定义的目标进行自我验证。
• 同步状态：自动更新Jira状态并对进度留下详细评论。

工作流程

1. 代理连接到Jira：代理会验证并检索您分配的票证。
2. 门票已加载到会话中：会话的活动票证已缓存。
3. 解析票证描述：系统会查找目标和触发器等特定标签。
4. 检测到运行MCP触发器：如果找到，则会提醒代理任务已准备好执行。
5. 代理执行任务：代理读取代码，实现更改并验证它们。
6. QA部分已验证：代理人核对工作是否符合要求 QA 门票中的标准。
7. 评论已添加到Jira：工作报告（以及任何验证证明）作为评论发布。
8. 门票转换为审核中：最后，票证将移动到“审核中”状态。

什么是并排？

并排 是一个可选的身份验证和功能层，可以与此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_AUTH

1. 对您的凭据进行编码：

   echo -n "email@example.com:your_api_token" | base64

1. 将输出字符串用作 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 目标列表中是触发自动化的因素。_

门票最佳实践

为了减轻幻觉并提高质量，请始终包括：

1. 描述：上下文 _为什么_ 和 _什么_ （当前状态与期望状态）。
2. 目标：明确的成功标准。使用 Goal: 标签。
3. 问答：验证步骤。这有助于代理人自我纠正。

故障模式和保护措施

• 状态转换失败：如果代理试图将工单移动到不允许的状态（例如严格的工作流规则），该工具将返回一条错误消息，解释有效的转换。
• 缺少QA：如果缺少QA部分，代理可能不知道如何验证其工作。最好的做法是始终包含它们。
• 连接问题：如果 jira-verify-connection 失败，请检查您的 JIRA_AUTH 和 JIRA_URL.确保Docker容器可以访问互联网。

谁应该使用这个？

此MCP服务器非常适合以下团队：

• 使用 Jira 作为发展任务的真理来源。
• 跑 AI代理 IDE内部（如VS Code或Antigravity）。
• 想要 受控、可审计的自动化 他们的开发工作流程。
• 要求执行任务 状态转换 和 评论 作为完成定义的一部分。