🚀 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 - 大多数系统通常已预装
操作步骤
- 获取代码
git clone git@github.com:redhat-ai-tools/jira-mcp.git
cd jira-mcp
- 构建镜像并配置Cursor
此步骤还会创建一个类似于 example.env 的
~/.rh-jira-mcp.env文件。
make setup
- 准备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 文件。