杰拉-MCP

Name: 杰拉-MCP
Author: redhat-community-ai-tools

作者：redhat-community-ai-tools15 星标更新：2025-09-26

安装使用来源：spider==github.com

项目介绍

redhat-ai-tools/jira-mcp

一个容器化的Python MCP服务器，用于Cursor访问Jira。

[!IMPORTANT] 该项目是实验性的，并最初作为学习练习创建。请注意，还有更多功能强大且成熟的Jira MCP解决方案可用，如sooperset/mcp-atlassian，以及Atlassian自己的MCP Server。

另见redhat-ai-tools/jira-mcp-snowflake，它提供了另一种访问Red Hat Jira数据的方法。

快速开始

准备Jira令牌
- 前往Red Hat Jira个人访问令牌并创建一个令牌
- 创建类似于example.env的.env文件
配置Cursor
- 在Cursor中，前往“设置” -> “工具与集成”，点击“新建MCP服务器”
- 粘贴以下JSON，（或在mcpServers键下插入jiraMcp对象）。
- 更新"/path/to/your/dotenv/file.env"指向步骤1中的文件。
- 保存

{
  "mcpServers": {
    "jiraMcp": {
      "command": "podman",
      "args": [
        "run",
        "-i",
        "--rm",
        "--env-file",
        "/path/to/your/dotenv/file.env",
        "quay.io/sbaird/jira-mcp:latest"
      ],
      "description": "一个容器化的MCP服务器，用于查询Jira问题"
    }
  }
}

开发者快速开始

前提条件
- podman - 使用sudo dnf install podman（Fedora/RHEL）或brew install podman（macOS）安装
- yq - 使用sudo dnf install yq（Fedora/RHEL）或brew install yq（macOS）安装
- make - 大多数系统上通常已预装
获取代码

git clone git@github.com:redhat-ai-tools/jira-mcp.git
cd jira-mcp

构建镜像并配置Cursor<br> 这也会创建一个类似这个的~/.rh-jira-mcp.env文件。

make setup

准备Jira令牌
- 前往Red Hat Jira个人访问令牌并创建一个令牌
- 编辑家目录下的.rh-jira-mcp.env文件并粘贴令牌
决定是否启用写操作

启用你的MCP服务器对Jira进行编辑可能非常有用，但如果使用不当也可能导致很多问题。默认情况下，服务器禁用了写操作。如果你想启用它，请编辑家目录下的.rh-jira-mcp.env文件，设置JIRA_ENABLE_WRITE=true。

检查Cursor中是否正常工作

确认其正常工作，运行Cursor，前往设置并点击“工具与集成”。在MCP工具下你应该能看到“jiraMcp”，如果JIRA_ENABLE_WRITE=false（默认值），则有20个工具启用；如果JIRA_ENABLE_WRITE=true，则有30个工具启用。

与基于HTTP的MCP应用程序一起使用

如果你希望使用此MCP服务器与通过HTTP通信的应用程序一起使用，则需要使用基于HTTP的传输机制运行服务器。这是一个使用Streamable HTTP的示例，这是目前推荐的基于http的传输机制：

export $(grep -v '^#' ~/.rh-jira-mcp.env | xargs) && python server.py --transport http --port 3075

这是一个使用SSE的示例，这是一种已弃用的基于http的传输机制（例如，因为你有一个依赖于SSE的老版本MCP客户端应用程序）：

export $(grep -v '^#' ~/.rh-jira-mcp.env | xargs) && python server.py --transport sse --port 3075

可用工具

此MCP服务器提供以下工具：

问题搜索与检索

get_jira - 根据键获取特定Jira问题的详细信息。
search_issues - 使用JQL搜索问题

问题创建与管理

create_issue - 创建新的Jira问题，包括总结、描述、类型、优先级和分配人
update_issue - 更新现有问题的总结、描述、优先级或分配人
delete_issue - 删除Jira问题（谨慎使用）

问题评论

get_issue_comments - 获取Jira问题的所有评论
add_comment - 向Jira问题添加评论
delete_comment - 从Jira问题删除评论

问题分配

assign_issue - 将Jira问题分配给用户
unassign_issue - 取消分配Jira问题

问题流程与状态

transition_issue - 将Jira问题过渡到新状态（如“进行中”，“完成”）
get_issue_transitions - 获取Jira问题的可用转换

问题标签

add_issue_labels - 向Jira问题添加标签
remove_issue_labels - 从Jira问题移除标签

项目管理

list_projects - 列出所有项目
get_project - 根据键获取项目详细信息
get_project_components - 获取项目的组件
get_project_versions - 获取项目的版本
get_project_roles - 获取项目的角色
get_project_permission_scheme - 获取项目的权限方案
get_project_issue_types - 获取项目的问题类型

看板与冲刺管理

list_boards - 列出所有看板
list_sprints - 列出看板的冲刺
get_sprint - 根据ID获取冲刺详细信息
get_sprints_by_name - 根据名称获取看板的冲刺，可选地根据状态过滤

用户管理

search_users - 根据查询搜索用户
get_user - 根据账户ID获取用户详细信息
get_current_user - 获取当前用户信息
get_assignable_users_for_project - 获取项目可分配用户
get_assignable_users_for_issue - 获取问题可分配用户

开发命令

make build - 构建镜像
make run - 运行容器
make clean - 清理构建的镜像
make cursor-config - 修改~/.cursor/mcp.json以安装此MCP服务器
make setup - 构建镜像，配置Cursor，并创建~/.rh-jira-mcp.env（如果不存在）

故障排除

服务器无法启动

确认make run可以正常工作
检查JIRA_API_TOKEN是否正确
使用podman images jira-mcp验证镜像是否成功构建
转到Cursor底部面板的“输出”选项卡，选择下拉菜单中的“MCP日志”并检查日志
（MacOS）jiraMcp出现在Cursor工具部分但没有显示任何活动工具：
- 编辑mcp.json文件中jiraMcp的args部分，包含到.rh-jira-mcp.env文件的完整路径。
- 示例："~/.rh-jira-mcp.env", 更改为 "/Users/your_username/.rh-jira-mcp.env",

连接问题

配置更改后重启Cursor
检查Cursor的开发者控制台中的错误消息
验证Jira URL可以从你的网络访问

许可证

本项目采用MIT许可证。详情参见LICENSE文件。