JIRA MCP 服务器

这是一个模型上下文协议 (MCP) 服务器，提供与 JIRA 交互的工具。它允许您从活跃的 Sprint 中获取任务单，并通过 MCP 接口获取详细的任务单信息。

功能

该服务器提供以下工具：

1. list-sprint-tickets: 获取给定项目活跃 Sprint 中的所有任务单

   • 必需参数: projectKey (字符串)

2. get-ticket-details: 获取特定任务单的详细信息

   • 必需参数: issueKey (字符串)

3. add-comment: 向特定任务单添加评论

   • 必需参数: issueKey (字符串)
   • 必需参数: comment (字符串)

4. link-tickets: 将两个任务单链接为“关联”关系

   • 必需参数: sourceIssueKey (字符串)
   • 必需参数: targetIssueKey (字符串)

5. update-description: 更新特定任务单的描述

   • 必需参数: issueKey (字符串)
   • 必需参数: description (字符串)

6. list-child-issues: 获取父任务单的所有子任务

   • 必需参数: parentKey (字符串)

7. create-sub-ticket: 为父任务单创建一个子任务单（子任务）

   • 必需参数: parentKey (字符串)
   • 必需参数: summary (字符串)
   • 可选参数: description (字符串)
   • 可选参数: issueType (字符串) - 子任务单类型名称 (例如, 'Sub-task')

设置

1. 安装依赖:

   npm install
   

2. 构建 TypeScript 代码:

此步骤仅在 Windows 上的 Cline 上需要，它目前在执行 npx 时存在问题

npm run build

3. 在您的 Claude 应用程序设置文件（通常位于 macOS 上的 ~/Library/Application Support/Claude/claude_desktop_config.json 或 Windows 上的 %APPDATA%/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json）中配置 MCP 设置：

Claude 的设置:

{
  "mcpServers": {
    "jira": {
      "command": "npx",
      "args": ["path/to/this/repo/jira.ts"],
      "env": {
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

Cline 的设置:

{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["path/to/this/repo/dist/jira.js"],
      "env": {
        "JIRA_HOST": "https://your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token"
      }
    }
  }
}

配置

您需要在 MCP 设置中设置以下环境变量：

1. JIRA_HOST: 您的 Atlassian 域名 URL (例如, https://your-company.atlassian.net)
2. JIRA_EMAIL: 您的 JIRA 帐户电子邮件
3. JIRA_API_TOKEN: 您的 JIRA API 令牌
   • 您可以从您的 Atlassian 帐户设置 生成 API 令牌

用法

配置完成后，您可以通过 Claude 中的 MCP 接口使用这些工具：

列出 Sprint 任务单

要获取项目活跃 Sprint 中的所有任务单：

<use_mcp_tool>
<server_name>jira</server_name>
<tool_name>list-sprint-tickets</tool_name>
<arguments>
{
  "projectKey": "YOUR_PROJECT_KEY"
}
</arguments>
</use_mcp_tool>

获取任务单详情

要获取特定任务单的详细信息：

<use_mcp_tool>
<server_name>jira</server_name>
<tool_name>get-ticket-details</tool_name>
<arguments>
{
  "issueKey": "PROJECT-123"
}
</arguments>
</use_mcp_tool>

开发

该服务器使用 TypeScript 编写，并使用：

• @modelcontextprotocol/sdk 用于 MCP 服务器实现
• jira.js 用于 JIRA API 集成

要修改服务器：

1. 对 jira.ts 进行更改
2. 运行 npm run build 以编译为 JavaScript
3. 重新启动 Claude 以获取更改

错误处理

服务器包括以下错误处理：

• 无效的 JIRA 凭据
• 缺少活跃的 Sprint
• 无效的项目键或任务单键
• 网络错误

错误消息将返回在工具响应中。