使用说明

SprintWise–Jira MCP服务器

视频直播链接

PPT请参考存储库“Team Titans-Presentation.pptx” 链接

泰坦队

2025年5月30日

团队成员

Ashutosh Mishra，软件工程师团队负责人， @阿舒特米2
Lavanya Sai Kumar Kantubhukta，软件工程师， @alkantubh
Amal Nazar Rajeena，软件工程师， @阿纳扎拉

概述

SprintWise是一款基于人工智能的Jira MCP服务器，它彻底改变了敏捷项目管理。

MCP是一个开放协议，它规范了应用程序如何向LLM提供上下文。将MCP想象成AI应用程序的USB-C端口。正如USB-C提供了一种将设备连接到各种外围设备和配件的标准化方式一样，MCP提供了一个将AI模型连接到不同数据源和工具的标准化方法。

特性

Jira MCP服务器-SprintWise

优化待办事项整理
智能用户故事分配
检查用户故事合规性
识别阻断器
提供见解以提高团队绩效
支持所有CRUD操作。

可用工具

1.用户管理

// Get user's account ID by email
{
  email: "user@example.com";
}

2.问题类型管理

// List all available issue types
// Returns: id, name, description, subtask status
// No parameters required

3.问题链接类型

// List all available issue link types
// Returns: id, name, inward/outward descriptions
// No parameters required

4.问题管理

检索问题

// Get all issues in a project
{
  projectKey: "PROJECT"
}

// Get issues with JQL filtering
{
  projectKey: "PROJECT",
  jql: "status = 'In Progress' AND assignee = currentUser()"
}

// Get issues assigned to user
{
  projectKey: "PROJECT",
  jql: "assignee = 'user@example.com' ORDER BY created DESC"
}

制造问题

// Create a standard issue
{
  projectKey: "PROJECT",
  summary: "Issue title",
  issueType: "Task",  // or "Story", "Bug", etc.
  description: "Detailed description",
  assignee: "accountId",  // from get_user tool
  labels: ["frontend", "urgent"],
  components: ["ui", "api"],
  priority: "High"
}

// Create a subtask
{
  parent: "PROJECT-123",
  projectKey: "PROJECT",
  summary: "Subtask title",
  issueType: "Subtask",
  description: "Subtask details",
  assignee: "accountId"
}

更新问题

// Update issue fields
{
  issueKey: "PROJECT-123",
  summary: "Updated title",
  description: "New description",
  assignee: "accountId",
  status: "In Progress",
  priority: "High"
}

问题依赖关系

// Create issue link
{
  linkType: "Blocks",  // from list_link_types
  inwardIssueKey: "PROJECT-124",  // blocked issue
  outwardIssueKey: "PROJECT-123"  // blocking issue
}

删除问题

// Delete single issue
{
  issueKey: "PROJECT-123"
}

// Delete issue with subtasks
{
  issueKey: "PROJECT-123",
  deleteSubtasks: true
}

// Delete multiple issues
{
  issueKeys: ["PROJECT-123", "PROJECT-124"]
}

字段格式

描述字段

描述字段支持标记样式格式：

在段落之间使用空行
使用“-”表示要点
使用“1。“用于编号列表
使用以“：”结尾的标题（后跟空行）

例子：

Task Overview:

This task involves implementing new features:
- Feature A implementation
- Feature B testing

Steps:
1. Design component
2. Implement logic
3. Add tests

Acceptance Criteria:
- All tests passing
- Documentation updated

错误处理

服务器为以下对象提供详细的错误消息：

问题密钥无效
缺少必填字段
权限问题
API费率限制

安装说明

克隆存储库：

git clone https://github.com/cisco-it-hackathon/titans-sprintwise
cd Titans-Sprintwise

安装依赖项：
```
npm install
```

配置环境变量：创建一个 .env 根目录中的文件：

JIRA_HOST=your-instance.atlassian.net
JIRA_EMAIL=your-email@example.com
JIRA_API_TOKEN=your-api-token

构建项目：
```
npm run build
```
启动服务器：
```
npm start
```

演示

GitHub Copilot–带LLM Claude 3.7 Sonnet的MCP客户端
服务器在VS代码中本地运行（stdio）

未来潜力

智能洞察： 提供数据驱动的洞察，了解团队速度、估计准确性和反馈趋势，以推动持续改进。
自动报告： 生成季度报告，总结团队绩效、关键成就、阻碍因素和可操作的建议，节省数小时的人工时间。
主动阻断检测： 警报团队会发现潜在的风险和阻碍因素，并提出解决方案以使项目保持正轨。

注：我们无法演示这些功能，因为很难在演示Jira帐户中重新创建它，并且在实际的企业Jira中使用MCP存在安全风险。