JIRA MCP Server

JIRA MCP Server

site icon
2025.04.12 0
PythonJIRA 集成工作流自动化开发工具交流协作开发效率
vibe-coded-jira-mcp 是一个基于 Model Context Protocol (MCP) 的 JIRA 集成服务器,旨在为 Cursor IDE 提供无缝的 JIRA 数据交互能力。该服务器支持通过 JIRA Query Language (JQL) 搜索问题、创建和更新问题、添加评论、克隆问题以及记录工作时间等功能。适用于个人开发者和小型团队,用于自动化 JIRA 工作流程。
View on GitHub

Overview

基本能力

产品定位

vibe-coded-jira-mcp 是一个用于集成 JIRA 与 Cursor IDE 的 MCP 服务器,通过标准化协议实现 LLM 应用程序与外部数据源的交互。

核心功能

  • 通过关键字获取 JIRA 问题
  • 使用 JQL 搜索问题
  • 创建和更新问题(对高度自定义的 JIRA 项目可能有限制)
  • 添加评论到问题
  • 克隆问题(适用于绕过强制自定义字段,但对复杂项目配置可能有限制)
  • 可配置的字段选择
  • 分页支持
  • 详细的错误处理和日志记录
  • 记录工作时间

适用场景

  • 个人开发者自动化 JIRA 工作流程
  • 小型团队在受信任环境中管理 JIRA 问题
  • 开发者在 Cursor IDE 中直接与 JIRA 交互

工具列表

  • JQL 查询工具:支持复杂的 JIRA 问题搜索
  • 问题克隆工具:快速复制和修改现有问题
  • 评论工具:直接在 IDE 中添加和管理问题评论

常见问题解答

  • 问题克隆限制:对复杂项目配置可能无法完全克隆所有字段。
  • 自定义字段支持:高度自定义的 JIRA 项目可能需要额外配置。
  • 安全性:建议使用 API 令牌而非密码,并确保 .env 文件安全。

使用教程

使用依赖

  1. 创建虚拟环境:
python -m venv venv
source venv/bin/activate  # Windows: venv\Scripts\activate
  1. 安装依赖:
pip install -r requirements.txt
  1. 配置环境变量: 创建 .env 文件并添加:
JIRA_URL=your_jira_url
JIRA_USERNAME=your_username
JIRA_API_TOKEN=your_api_token

安装教程

运行服务器:

./run-jira-mcp.sh

调试方式

  1. 检查日志文件以查看错误信息。
  2. 确保环境变量正确配置。
  3. 验证 JIRA API 令牌是否有足够权限。

许可证

该项目遵循 MIT 开源许可条款。