Jira MCP Server

Jira MCP Server

site icon
2025.01.03 1
JavaScript项目管理团队协作交流协作
Jira MCP Server 是一个模型上下文协议服务器,提供与Jira REST API的集成,允许AI助手以编程方式管理Jira问题。该服务器具备创建、列出、更新、获取、删除Jira问题以及添加评论等功能。
View on GitHub

Overview

基本能力

产品定位

Jira MCP Server 是一个用于与Jira系统集成的中间件,使AI助手能够通过编程方式管理Jira问题。

核心功能

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

适用场景

  • 自动化Jira问题管理
  • AI助手与Jira系统的集成
  • 批量处理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