Jira MCP

🚀 redhat-ai-tools/jira-mcp

这是一个容器化的Python MCP服务器，专为Cursor设计，用于访问Jira。

🚀 快速开始

本项目具有实验性质，最初是作为学习练习创建的。需要注意的是，市面上有更强大、更成熟的Jira MCP解决方案，例如 sooperset/mcp-atlassian 以及Atlassian官方的 MCP Server。

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

📦 安装指南

前提条件

• podman - 使用 sudo dnf install podman（Fedora/RHEL）或 brew install podman（macOS）进行安装
• make - 大多数系统通常已预装

操作步骤

1. 获取代码

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

2. 构建镜像并配置Cursor 此步骤还会创建一个类似于 example.env 的 ~/.rh-jira-mcp.env 文件。

make setup

3. 准备Jira令牌
   • 访问 Red Hat Jira个人访问令牌 并创建一个令牌。
   • 编辑主目录下的 .rh-jira-mcp.env 文件，并粘贴该令牌。

要确认其是否正常工作，请运行Cursor，转到设置并点击“工具与集成”。在MCP工具下，您应该会看到“jiraMcp”，并且已启用20个工具。

✨ 主要特性

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

问题搜索

• get_jira - 按密钥获取特定Jira问题的详细信息。
• search_issues - 使用JQL搜索问题。

项目管理

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

看板与冲刺管理

• list_boards - 列出所有看板。
• get_board - 按ID获取看板详细信息。
• list_sprints - 列出看板的冲刺。
• get_sprint - 按ID获取冲刺详细信息。
• get_issues_for_board - 获取看板的问题。
• get_issues_for_sprint - 获取冲刺的问题。

用户管理

• 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日志”并检查其中的日志。

连接问题

• 在配置更改后重启Cursor。
• 检查Cursor的开发者控制台是否有错误消息。
• 验证Jira URL是否可以从您的网络访问。

📄 许可证

本项目采用MIT许可证。有关详细信息，请参阅 LICENSE 文件。