Jira MCP Server

Jira MCP Server

site icon
2025.03.23 1
Python项目管理问题跟踪工作流自动化交流协作
mcp-jira 是一个基于 Model Context Protocol (MCP) 的服务器,用于通过自然语言命令与 Jira 的 REST API 交互。它集成了 Claude Desktop 和其他 MCP 客户端,使用户能够通过自然语言命令管理 Jira 项目、问题和评论等。
View on GitHub

Overview

基本能力

产品定位

mcp-jira 是一个用于与 Jira 系统交互的中间件服务,通过自然语言命令简化 Jira 项目管理流程。

核心功能

  • 获取所有可访问的 Jira 项目
  • 获取特定 Jira 问题的详细信息
  • 使用 JQL (Jira Query Language) 搜索问题
  • 创建新的 Jira 问题
  • 向问题添加评论
  • 获取问题的可用工作流转换
  • 将问题转换到新状态

适用场景

  • 团队项目管理
  • 问题跟踪和报告
  • 自动化工作流程
  • 与聊天机器人集成进行项目管理

工具列表

  1. get_projects: 获取所有可访问的 Jira 项目
  2. get_issue: 通过键获取特定 Jira 问题的详细信息
  3. search_issues: 使用 JQL 搜索 Jira 问题
  4. create_issue: 创建新的 Jira 问题
  5. add_comment: 向 Jira 问题添加评论
  6. get_transitions: 获取 Jira 问题的可用工作流转换
  7. transition_issue: 将 Jira 问题转换到新状态

常见问题解答

  • 支持多种认证方式:基本认证、API 令牌和个人访问令牌
  • 可与 Jira Cloud、Server 或 Data Center 版本集成
  • 需要 Python 3.9 或更高版本

使用教程

使用依赖

  • Python 3.9 或更高版本
  • Jira 实例(Cloud、Server 或 Data Center)
  • uv(推荐用于依赖管理)

安装教程

激活虚拟环境(推荐)

# 在 mcp 服务器目录中安装虚拟环境 (VENV)
python -m venv .
# 激活虚拟环境
source bin/activate

使用 uv(推荐)

# 安装 uv(如果没有)
pip install uv

# 安装 Jira MCP 服务器
uv pip install mcp-server-jira

使用 pip

pip install mcp-server-jira

调试方式

命令行运行

python -m mcp_server_jira

Docker 运行

docker build -t mcp-jira .
docker run --env-file .env -p 8080:8080 mcp-jira

许可证

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