AI导哈

Jira集成服务器

一个基于Jira REST API v3的Model Context Protocol (MCP)服务器，允许LLM作为项目管理和个人助理工具，为使用Jira的团队提供服务。

  • by Warzuponus
  • Python
  • 本地部署
  • 10 星标
  • 更新于
在 GitHub 查看 Warzuponus/mcp-jira

使用说明

MCP Jira集成

Jira的一个简单的模型上下文协议（MCP）服务器，允许LLM充当使用Jira的团队的项目经理和个人助理。基于Jira REST API v3。

特性

核心MCP工具

  • 创建_发行 -使用正确的格式和ADF描述创建新的Jira问题
  • 搜索问题 -使用JQL进行智能格式化和分页搜索问题
  • get_print_status -获取包含指标的全面冲刺进度报告
  • get_team_workload -分析团队成员的工作量和能力
  • generate_standup_report -自动生成每日站立报告

项目管理能力

  • 多项目支持：通过动态指定项目键来处理多个项目
  • 使用视觉指示器跟踪Sprint进度
  • 团队工作量分析和能力规划
  • 自动生成每日站立报告
  • 创建具有适当优先级的问题
  • 智能搜索和过滤问题

可靠性

  • 在速率限制（429）和瞬态错误（503）上具有指数回退的自动重试
  • 大型结果集的分页
  • 时区感知日期处理
  • 优雅地处理自定义Jira状态和问题类型

需求

  • Python 3.8或更高版本
  • 使用API令牌的Jira云帐户
  • MCP兼容客户端（如克劳德桌面）

快速设置

  1. 克隆并安装:
git clone https://github.com/your-org/mcp-jira.git
cd mcp-jira
python3 -m venv .venv
source .venv/bin/activate
pip install -e .
  1. 配置Jira凭据:
cp .env.example .env
# Edit .env with your values

JIRA_URL=https://your-domain.atlassian.net
JIRA_USERNAME=your.email@domain.com
JIRA_API_TOKEN=your_api_token
PROJECT_KEY=PROJ
DEFAULT_BOARD_ID=123
  1. 测试服务器:
.venv/bin/python -m mcp_jira

你应该看看 Initializing MCP Jira server... 在输出中。按 Ctrl+C 停止。

用法示例

制造问题

“为登录系统无法正常工作创建高优先级错误”

  • 自动分配适当的问题类型、优先级和格式

Sprint管理

“我们目前的冲刺状态是什么？”

  • 获取包含指标和视觉指标的全面进度报告

团队管理

“给我看看john.doe、jane.smith、mikewilson的团队工作量”

  • 分析容量并提供工作负载分布

每日站立

“生成今天的站立报告”

  • 创建包含已完成、正在进行和已阻止项目的格式化报告

MCP集成

使用克劳德桌面

配置文件位于：

  • macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
  • 视窗: %APPDATA%\Claude\claude_desktop_config.json

添加以下条目，替换 /path/to/mcp-jira 使用克隆repo的绝对路径：

{
  "mcpServers": {
    "mcp-jira": {
      "command": "/path/to/mcp-jira/.venv/bin/python",
      "args": ["-m", "mcp_jira"]
    }
  }
}

备注：从内部使用Python二进制文件 .venv 文件夹——这确保了所有依赖项都可用。这 cwd 字段不是必需的；服务器在内部使用绝对路径解析其配置。

要找到正确的路径，请在项目目录中运行以下命令：

echo "$(pwd)/.venv/bin/python"

保存配置后重新启动Claude Desktop。

与其他MCP客户端

服务器遵循标准的MCP协议，并与任何兼容MCP的客户端一起工作。

配置

所需的环境变量

  • JIRA_URL -您的Jira实例URL
  • JIRA_USERNAME -您的Jira用户名/电子邮件
  • JIRA_API_TOKEN -您的Jira API代币
  • PROJECT_KEY -操作的默认项目密钥（可以根据请求覆盖）

可选设置

  • DEFAULT_BOARD_ID -sprint操作的默认板（可以根据请求覆盖）
  • STORY_POINTS_FIELD -故事点的自定义字段ID（默认值：customfield_10026）
  • DEBUG_MODE -启用调试日志记录（默认值：false）
  • LOG_LEVEL -日志记录级别（默认值：INFO）

获取Jira API代币

  1. 首选 Atlassian帐户设置
  2. 点击“创建API令牌”
  3. 为其命名并复制令牌
  4. 使用您的电子邮件作为用户名，令牌作为密码

建筑

此实现优先考虑简单性和可靠性：

  • 单个MCP服务器文件 -所有工具放在一个地方
  • 标准MCP协议 -使用官方MCP SDK
  • Jira REST API v3 -使用Atlassian文档格式（ADF）进行描述
  • 丰富的格式 -提供美观、易读的报告
  • 使用回退重试 -自动处理速率限制和短暂的Jira API错误
  • 分页 -获取大型问题集的所有结果
  • 错误处理 -优雅地处理Jira API问题和自定义状态
  • 异步支持 -快速响应的操作

故障排除

常见问题

  1. “未找到活动冲刺”

    • 确保你的董事会有一个积极的冲刺
    • 检查一下 DEFAULT_BOARD_ID 设置正确

  2. 身份验证错误

    • 验证您的API令牌是否正确
    • 检查您的用户名是否是您的电子邮件地址

  3. 权限错误

    • 确保您的Jira用户具有适当的项目权限
    • 检查项目密钥是否存在以及您是否有访问权限

调试模式

集 DEBUG_MODE=true 在你的 .env 详细日志记录文件。

发展

  1. 分叉存储库
  2. 设置开发环境：
python3 -m venv .venv
source .venv/bin/activate
pip install -e ".[dev]"
  1. 运行测试：
python -m pytest tests/ -v
  1. 提交拉取请求

许可证

MIT许可证-请参阅许可证文件

相关 MCP