AI导哈

Jira项目管理服务器

一个全面的Jira项目管理集成服务器，提供问题管理、工作流管理、评论管理和冲刺管理等功能。

  • by indrajithi
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 indrajithi/jira-mcp-server

使用说明

Jira MCP服务器

一个全面的模型上下文协议（MCP）服务器，用于与Claude Code完全集成Jira项目管理。

✨ 特性

🎯 核心问题管理

  • jira_search：使用JQL或简单过滤器搜索Jira问题
  • jira_get_issue：获取有关特定问题的详细信息
  • jira_create_issue：创建新的Jira问题
  • jira_update_issue：用新信息更新现有问题
  • jira-delete_issue：永久删除问题（带安全确认）
  • jira_assign_issue：向用户分配或取消分配问题

🔄 工作流管理

  • jira_transition问题：通过工作流转换更改问题状态
  • jira_get_转换：获取任何问题的可用转换

💬 评论管理

  • jira_add_注释：为协作问题添加评论
  • jira_get_注释：检索问题中的所有评论

🏃‍♂️ Sprint管理

  • jira_create_sprint：在板上创建新的冲刺
  • jira_get_sprints：列出一个板的所有冲刺（带状态过滤）
  • jira_get_sprint_分析：获取详细的冲刺指标和分析

📊 项目信息

  • jira_list_项目：列出所有可访问的项目
  • jira_get_project_info：获取详细的项目信息和统计数据

设置

  1. 安装依赖项:

    npm install

  2. 配置环境: 复制 .env 并使用您的Jira凭据进行更新：

    JIRA_URL=https://your-company.atlassian.net
JIRA_USERNAME=your.email@company.com
JIRA_API_TOKEN=your_api_token
JIRA_PROJECT_KEY=AR

  3. 构建并运行:

    npm run build
npm start

    或用于开发：

    npm run dev

Claude代码集成

服务器已在用户范围内全局注册：

claude mcp add --scope user jira-mcp-server /path/to/dist/index.js

📚 使用示例

核心问题管理

// Search all issues in project
jira_search({ project: "AR" })

// Search with JQL
jira_search({ jql: "status = 'To Do' AND priority = High" })

// Get issue details
jira_get_issue({ issueKey: "AR-1" })

// Create new issue
jira_create_issue({
  summary: "Fix login bug",
  description: "Users cannot log in with valid credentials",
  issueType: "Bug",
  priority: "High"
})

// Update existing issue
jira_update_issue({
  issueKey: "AR-1",
  summary: "Updated summary",
  priority: "Critical"
})

// Assign issue
jira_assign_issue({
  issueKey: "AR-1",
  assignee: "user@company.com"
})

// Delete issue (use with caution!)
jira_delete_issue({
  issueKey: "AR-1",
  confirm: true,
  deleteSubtasks: false
})

工作流管理

// Get available transitions
jira_get_transitions({ issueKey: "AR-1" })

// Transition issue with comment
jira_transition_issue({
  issueKey: "AR-1",
  transitionId: "21",
  comment: "Moving to In Progress as work has started"
})

评论管理

// Add comment
jira_add_comment({
  issueKey: "AR-1",
  comment: "This issue is ready for testing"
})

// Get all comments
jira_get_comments({ issueKey: "AR-1" })

Sprint管理

// Create new sprint
jira_create_sprint({
  name: "Sprint 15",
  boardId: 5,
  goal: "Complete user authentication features",
  startDate: "2025-06-18",
  endDate: "2025-07-01"
})

// Get all sprints for board
jira_get_sprints({ boardId: 5 })

// Get sprint analytics
jira_get_sprint_analytics({ sprintId: 123 })

项目信息

// List all projects
jira_list_projects({ includeDetails: true })

// Get project details
jira_get_project_info({ projectKey: "AR" })

🔄 完成项目管理工作流

Epic到Sprint工作流程

// 1. List projects and get project info
jira_list_projects()
jira_get_project_info({ projectKey: "AR" })

// 2. Create issues for your epic
jira_create_issue({
  summary: "User Authentication Epic",
  description: "Complete user authentication system",
  issueType: "Epic"
})

// 3. Create sprint and add issues
jira_create_sprint({
  name: "Authentication Sprint 1",
  boardId: 5,
  goal: "Implement login functionality"
})

// 4. Move issues through workflow
jira_get_transitions({ issueKey: "AR-5" })
jira_transition_issue({
  issueKey: "AR-5",
  transitionId: "21",
  comment: "Starting development"
})

// 5. Add progress updates
jira_add_comment({
  issueKey: "AR-5",
  comment: "Backend API implemented, testing in progress"
})

// 6. Monitor sprint progress
jira_get_sprint_analytics({ sprintId: 123 })

问题生命周期管理

// Create → Assign → Update → Transition → Comment → Complete
jira_create_issue({ summary: "Fix login validation" })
jira_assign_issue({ issueKey: "AR-6", assignee: "dev@company.com" })
jira_update_issue({ issueKey: "AR-6", priority: "High" })
jira_transition_issue({ issueKey: "AR-6", transitionId: "21" })
jira_add_comment({ issueKey: "AR-6", comment: "Fix deployed to staging" })
jira_transition_issue({ issueKey: "AR-6", transitionId: "31" })

🏗️ 建筑

src/
├── index.ts           # Main MCP server with all tool handlers
├── types/jira.ts      # Comprehensive TypeScript types and schemas
├── utils/
│   ├── config.ts      # Configuration loading with absolute paths
│   └── jira-client.ts # Extended Jira API client with agile support
└── tools/             # Complete MCP tool implementations
    ├── jira-search.ts
    ├── jira-get-issue.ts
    ├── jira-create-issue.ts
    ├── jira-update-issue.ts
    ├── jira-delete-issue.ts
    ├── jira-assign-issue.ts
    ├── jira-transition-issue.ts
    ├── jira-comments.ts
    ├── jira-sprint-management.ts
    └── jira-project-info.ts

配置

变量 描述 必填
JIRA_URL Jira实例URL 是
JIRA_USERNAME 您的电子邮件地址 是
JIRA_API_TOKEN 来自Jira的API令牌 是
JIRA_PROJECT_KEY 默认项目（例如“AR”） 否
MCP_VERBOSE 启用详细日志记录 否
API_TIMEOUT 请求超时（毫秒） 否

故障排除

  • 身份验证错误：验证API令牌是否有效
  • 权限错误：检查Jira项目权限
  • 连接问题：验证Jira URL和网络访问权限

许可证

麻省理工学院

相关 MCP