MCP Jira 集成

一个简单的模型上下文协议（MCP）服务器，用于Jira，允许大型语言模型（LLMs）作为使用Jira的团队的项目管理和个人助手。

功能

核心 MCP 工具

• create_issue - 使用正确的格式创建新的Jira问题
• search_issues - 使用智能格式化的JQL搜索问题
• get_sprint_status - 获取全面的冲刺进度报告
• get_team_workload - 分析团队成员的工作量和容量
• generate_standup_report - 自动生成每日站会报告

项目管理能力

• 带有视觉指示器的冲刺进度跟踪
• 团队工作量分析和容量规划
• 自动化每日站会报告生成
• 具有正确优先级的问题创建
• 智能搜索和过滤问题

要求

• Python 3.8 或更高版本
• 带有API令牌的Jira账户
• 兼容MCP的客户端（如Claude Desktop）

快速设置

1. 克隆并安装：

cd mcp-jira
pip install -e .

2. 配置Jira凭证 在.env中：

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

3. 运行MCP服务器：

python -m mcp_jira.simple_mcp_server

使用示例

创建问题

“为登录系统未正常工作的高优先级错误创建问题”

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

冲刺管理

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

• 获取带有指标和视觉指示器的全面进度报告

团队管理

“显示john.doe、jane.smith和mike.wilson的团队工作量”

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

每日站会

“生成今天的站会报告”

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

MCP集成

与Claude Desktop集成

在您的claude_desktop_config.json中添加：

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

与其他MCP客户端集成

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

配置

必要的环境变量

• JIRA_URL - 您的Jira实例URL
• JIRA_USERNAME - 您的Jira用户名/电子邮件
• JIRA_API_TOKEN - 您的Jira API令牌
• PROJECT_KEY - 操作的默认项目键

可选设置

• DEFAULT_BOARD_ID - 冲刺操作的默认看板ID
• DEBUG_MODE - 启用调试日志记录（默认：false）
• LOG_LEVEL - 日志级别（默认：INFO）

获取Jira API令牌

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

架构

此实现优先考虑简单性：

• 单个MCP服务器文件 - 所有工具都在一个地方
• 标准MCP协议 - 使用官方MCP SDK
• 丰富的格式化 - 提供美观、可读的报告
• 错误处理 - 对Jira API问题进行优雅处理
• 异步支持 - 快速响应的操作

故障排除

常见问题

1. “未找到活动冲刺”

   • 确保您的看板有一个活动冲刺
   • 检查DEFAULT_BOARD_ID是否设置正确

2. 身份验证错误

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

3. 权限错误

   • 确保您的Jira用户具有适当的项目权限
   • 检查项目键是否存在并且您有访问权限

调试模式

在您的.env文件中设置DEBUG_MODE=true以获取详细日志。

贡献

1. 分叉仓库
2. 进行更改
3. 使用您的Jira实例进行测试
4. 提交拉取请求

许可证

MIT许可证 - 请参阅LICENSE文件