Jira MCP Server

Jira MCP Server

site icon
2024.12.20 7
JavaScript项目管理团队协作自动化工具交流协作开发效率
Jira MCP Server 是一个模型上下文协议服务器,提供与Jira REST API的集成,允许AI助手以编程方式管理Jira问题。该服务器主要用于项目管理,支持创建、列出、更新、获取、删除Jira问题以及添加评论等功能。
View on GitHub

Overview

基本能力

产品定位

Jira MCP Server 是一个用于与Jira集成的服务,旨在通过AI助手自动化管理Jira问题,提升项目管理效率。

核心功能

  • 创建新问题(任务、史诗、子任务)
  • 列出问题(支持状态过滤)
  • 更新现有问题(摘要、描述、状态)
  • 获取详细问题信息
  • 删除问题
  • 向问题添加评论

适用场景

  • 自动化项目管理流程
  • 集成AI助手进行问题跟踪
  • 批量操作Jira问题
  • 开发团队协作管理

工具列表

  1. create_issue: 创建新的Jira问题
  2. 必需参数: working_dir, summary, description, type
  3. list_issues: 列出项目中的问题
  4. 必需参数: working_dir
  5. 可选参数: status
  6. update_issue: 更新现有问题
  7. 必需参数: working_dir, issue_key
  8. 可选参数: summary, description, status
  9. get_issue: 获取特定问题的详细信息
  10. 必需参数: working_dir, issue_key
  11. delete_issue: 删除Jira问题
  12. 必需参数: working_dir, issue_key
  13. add_comment: 向现有问题添加评论
  14. 必需参数: working_dir, issue_key, comment

常见问题解答

  • 错误处理包括:
  • 无效的项目键
  • 缺少配置
  • 无效的问题类型
  • API认证错误
  • 无效的状态转换

使用教程

使用依赖

  1. 需要具有API访问权限的Jira账户
  2. 需要Jira API令牌(可从Atlassian账户设置生成)

安装教程

  1. 安装依赖:
npm install
  1. 构建服务器:
npm run build

配置

  1. 在工作目录中创建.jira-config.json文件:
{
  "projectKey": "YOUR_PROJECT_KEY"
}
  1. 使用Jira凭据配置MCP服务器: 在MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json 在Windows: %APPDATA%/Claude/claude_desktop_config.json
{
  "mcpServers": {
    "jira": {
      "command": "node",
      "args": ["/path/to/jira-server/build/index.js"],
      "env": {
        "JIRA_EMAIL": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_DOMAIN": "your-domain"
      }
    }
  }
}

调试方式

开发时使用自动重建:

npm run watch

许可证

None