AI导哈

Jira问题管理服务器

一个基于MCP协议的Jira云实例交互服务器，提供搜索、创建、更新和管理Jira问题的工具和资源。

  • by PJSathischandar
  • 本地部署
  • 更新于
在 GitHub 查看 pjsathischandar/jira-mcp-server

使用说明

Jira MCP服务器

用于与Jira Cloud实例交互的模型上下文协议（MCP）服务器。此服务器提供工具和资源，用于通过MCP协议搜索、创建、更新和管理Jira问题。

特性

工具

  • search_issues（jcl，max_results=50） -使用JQL查询搜索问题
  • 获取问题（issue_key） -按关键字获取单个问题
  • create_issue（项目密钥、摘要、描述等） -创建新问题
  • comment_issue（issue_key，comment） -为问题添加评论
  • transition_issue（issue_key，transition） -通过工作流状态移动问题
  • get_transitions（issue_key） -获取问题的可用转换
  • assign_issue（issue_key、account_id、assignee_email） -将问题分配给用户
  • add_label（issue_key，标签） -为问题添加标签

资源（只读）

  • 问题：//{key} -按密钥获取问题详细信息
  • jql://{查询} -运行JQL搜索

先决条件

  • Python 3.8+
  • 具有API访问权限的Jira Cloud实例
  • Jira API代币

安装

  1. 克隆存储库：
git clone <repository-url>
cd jira-agent
  1. 安装依赖项：
pip install -r requirements.txt
  1. 设置环境变量：
cp .env.example .env

编辑 .env 使用您的Jira凭据：

JIRA_BASE=https://your-domain.atlassian.net
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token

获取Jira API代币

  1. 首选 Atlassian帐户设置
  2. 点击“创建API令牌”
  3. 给它一个标签并复制生成的令牌
  4. 在您的 .env 文件

用法

运行服务器

对于MCP客户端（如Claude Desktop）：

python jira-mcp.py

使用MCP开发检查员进行测试

mcp dev jira-mcp.py

Claude桌面配置

将此添加到您的Claude Desktop MCP配置中：

{
  "mcpServers": {
    "jira": {
      "command": "python",
      "args": ["/path/to/jira-agent/jira-mcp.py"],
      "cwd": "/path/to/jira-agent"
    }
  }
}

例子

搜索问题

# Search for issues in a specific project
search_issues("project = PROJ AND status = 'To Do'")

# Search for your assigned issues
search_issues("assignee = currentUser() AND status != Done")

制造问题

create_issue(
    project_key="PROJ",
    summary="Fix login bug",
    description="Users unable to login with special characters",
    issuetype="Bug",
    priority="High"
)

与Transitions合作

# Get available transitions
get_transitions("PROJ-123")

# Move issue to In Progress
transition_issue("PROJ-123", "In Progress")

备注

  • 对于Jira Cloud，用户分配需要 accountId （不是用户名/电子邮件）
  • 注释使用Atlassian文档格式（ADF）
  • 服务器使用Jira REST API v3

贡献

  1. 分叉存储库
  2. 创建要素分支
  3. 进行更改
  4. 如果适用，添加测试
  5. 提交拉取请求

许可证

MIT许可证-有关详细信息，请参阅许可证文件

相关 MCP