关键词

Jira项目管理任务追踪LLM工具工作流集成

项目简介

'jira-mcp-server' 是一个实现了 Model Context Protocol (MCP) 的后端服务，专门用于与 Atlassian Jira 集成。它允许支持 MCP 的大型语言模型（如 Cursor 或 Windsurf）通过标准化的协议访问和操作 Jira 数据。通过提供一系列“工具”，服务器赋能 AI 助手理解并执行用户提出的与 Jira 相关的任务请求。

主要功能点

这个 MCP 服务器为 LLM 提供了以下与 Jira 交互的能力：

  • 项目管理： 列出所有用户有权访问的 Jira 项目。
  • 任务详情： 根据任务的关键码（Issue Key）获取任务的详细信息，包括状态、经办人、描述、评论、变更历史等。
  • 任务搜索： 在指定项目中搜索任务，支持根据经办人进行过滤。
  • 成员列表： 列出指定 Jira 项目的所有成员及其角色。
  • 用户任务检查： 检查某个用户是否为项目成员，并列出分派给该用户在该项目中的所有任务。
  • 创建任务： 在指定项目中创建一个新的 Jira 任务，包括设置标题、描述、任务类型、经办人、报告人以及关联 Sprint。
  • Sprint 列表： 列出看板或项目相关的 Sprint，支持按状态（活跃、未来、关闭、全部）过滤，并显示 Sprint 中的任务概览。

安装步骤

要安装和运行此服务器，你需要 Node.js 环境。请遵循以下步骤：

# 克隆仓库
git clone https://github.com/samuelrizzo/jira-mcp-server.git
cd jira-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

这将在 'dist' 目录下生成服务器的 JavaScript 文件。

服务器配置

本服务器设计为通过 MCP 客户端（如 Cursor、Windsurf 等）启动和管理。你需要将本服务器添加到你的 MCP 客户端的配置文件中。典型的配置会包含以下信息：

  1. 服务器名称: 一个用于在客户端中识别本服务器的唯一名称，例如 '"jira-mcp"'。
  2. 启动命令 (command): 指定如何执行服务器的主文件。通常是 'node'。
  3. 启动参数 (args): 指定传递给启动命令的参数，例如指向编译后的主文件路径 './dist/index.js'。
  4. 环境变量 (env): 传递连接 Jira API 所需的认证信息。这包括：
    • 'JIRA_HOST': 你的 Jira 域名（例如 'your-domain.atlassian.net'）。
    • 'JIRA_EMAIL': 你用于访问 Jira 的邮箱地址。
    • 'JIRA_API_TOKEN': 你在 Jira 生成的用于 API 访问的令牌。你可以通过访问 Atlassian 账户设置 创建并获取 API 令牌。

请查阅你使用的 MCP 客户端的文档，了解具体的配置格式和文件位置。认证信息('JIRA_HOST', 'JIRA_EMAIL', 'JIRA_API_TOKEN')必须正确配置，服务器才能成功连接到你的 Jira 实例。

基本使用方法

在 MCP 客户端中正确配置并启动 'jira-mcp-server' 后，你就可以通过 AI 助手与 Jira 交互了。客户端会将你的自然语言请求发送给 AI 模型，模型会根据服务器声明的能力（即上述功能工具）判断是否需要调用某个工具，然后将调用请求发送给 'jira-mcp-server'。服务器执行操作并将结果返回给客户端和 AI 模型，最终由 AI 模型组织响应呈现给你。

你可以尝试向 AI 助手提问：

  • “列出我所有的 Jira 项目。”
  • “帮我查看任务 ABC-101 的详细信息。”
  • “在项目 XYZ 里搜索分派给我的所有任务。”
  • “在项目 DEV 里创建一个 bug，标题是 '支付功能异常'，描述是用户点击支付按钮无响应。”
  • “列出看板 5 的活跃 Sprint。”

信息

分类

开发者工具

访问项目