Jira任务管理工具

用于Jira Cloud集成的MCP服务器,使Claude能够管理PWP工作项,支持问题搜索、创建、更新和状态转换等功能。

  • by mideliberto
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 mideliberto/jira-mcp

使用说明

Jira MCP

MCP服务器用于Jira Cloud集成,使Claude能够管理PWP工作项。

特性

  • 搜索问题 JQL(Jira查询语言)
  • 获取问题详细信息 完整的上下文
  • 创建问题 具有完整的层次结构支持(Epic→ Task → 子任务)
  • 更新问题 -修改字段、优先级、受让人
  • 添加评论 记录决策和进展
  • 过渡问题 通过工作流状态
  • 获取过渡 -发现可用的工作流选项
  • 删除问题 -安全确认后的清理(⚠️ 永久)

安装

cd ~/dev/jira-mcp

# Create virtual environment
uv venv
source .venv/bin/activate

# Install dependencies
uv pip install -e .

配置

1.设置凭据

生成加密密钥:

python3 -c "from cryptography.fernet import Fernet; print(Fernet.generate_key().decode())"

设置环境变量:

export JIRA_ENCRYPTION_KEY='your-generated-key'

运行安装脚本:

python scripts/setup_credentials.py

2.配置克劳德桌面

添加到您的Claude桌面配置(~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "jira-pwp": {
      "command": "uv",
      "args": [
        "--directory",
        "/Users/mike/dev/jira-mcp",
        "run",
        "jira-mcp"
      ],
      "env": {
        "JIRA_ENCRYPTION_KEY": "your-encryption-key"
      }
    }
  }
}

3.重新启动克劳德桌面

Jira工具将出现在工具面板中。

快速开始

搜索问题

Search for open issues in ITHELP

创建问题

Create a task in ITPROJ to review the Q1 budget

更新问题

Set ITPROJ-42 to high priority

转型是一个问题

Move ITPROJ-42 to In Progress

项目

项目 目的 问题类型
ITPROJ IT项目 史诗、任务、子任务
ITHELP IT帮助台 服务请求、事件、问题
ITCM 变更管理 (各不相同)

文档

发展

# Run tests
python -m pytest tests/

# Test connection
python scripts/test_connection.py

# Run server directly
python -m jira_mcp.server

许可证

麻省理工学院