Jira MCP Server

Jira MCP Server

site icon
2025.03.21 0
TypeScriptJira 集成项目管理团队协作交流协作
Jira MCP Server 是一个基于 Model Context Protocol (MCP) 的 Jira 集成服务,旨在帮助 AI 助手(如 Claude)通过 MCP 与 Jira 进行交互。该服务器提供了丰富的功能,包括项目管理、问题跟踪、成员管理以及问题创建等,适用于团队协作和项目管理场景。
View on GitHub

Overview

基本能力

产品定位

Jira MCP Server 是一个用于 Jira 集成的 MCP 服务器,旨在通过 MCP 协议实现 AI 助手与 Jira 的交互,提升团队协作和项目管理的效率。

核心功能

  • 列出所有 Jira 项目
  • 获取问题的详细信息
  • 按项目和分配人搜索问题
  • 列出项目成员
  • 检查用户的项目成员资格和分配的问题
  • 创建带有自定义字段的新问题
  • 列出和查询带有过滤选项的冲刺

适用场景

  • 团队协作:通过 AI 助手快速查询和创建 Jira 问题,提升团队协作效率。
  • 项目管理:实时获取项目状态、成员任务分配情况,便于项目管理。
  • 自动化工作流:结合 AI 助手实现 Jira 任务的自动化创建和查询。

工具列表

  1. List Projects (mcp_jira_list_projects): 列出认证用户有权访问的所有 Jira 项目。
  2. Get Issue Details (mcp_jira_get_issue): 获取特定 Jira 问题的详细信息。
  3. Search Issues (mcp_jira_search_issues): 在特定项目中搜索问题,可选按分配人过滤。
  4. List Project Members (mcp_jira_list_project_members): 列出特定 Jira 项目的所有成员。
  5. Check User Issues (mcp_jira_check_user_issues): 检查用户是否是项目成员并列出其分配的问题。
  6. Create Issue (mcp_jira_create_issue): 在 Jira 项目中创建带有指定详细信息的新问题。
  7. List Sprints (mcp_jira_list_sprints): 列出 Jira 中的当前冲刺,带有过滤选项。

常见问题解答

  • 如何生成 Jira API 令牌? 前往 Atlassian Account Settings,点击 "Create API Token",命名后复制令牌。
  • 如何配置 MCP 服务器? 在 cursor/windsurf mcp 设置文件中添加配置,包括 Jira 主机、邮箱和 API 令牌。

使用教程

使用依赖

  • Node.js
  • npm

安装教程

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

# 安装依赖
npm install

# 构建项目
npm run build

调试方式

  1. 确保配置文件中包含正确的 Jira 主机、邮箱和 API 令牌。
  2. 运行以下命令启动服务器:
node ./dist/index.js
  1. 使用示例查询测试功能,如:
"List all Jira projects in PROJECT"
"Get details for issue PROJECT-123"

许可证

该项目遵循 MIT 开源许可条款,请参阅 MIT 了解完整条款。