AI导哈

Jira问题管理服务器

一个提供与Jira REST API集成的模型上下文协议服务器，允许AI助手以编程方式管理Jira问题。

  • by 1broseidon
  • JavaScript
  • 本地部署
  • 11 星标
  • 更新于
在 GitHub 查看 1broseidon/mcp-jira-server

使用说明

Jira MCP服务器

一个模型上下文协议服务器，提供与Jira的REST API的集成，允许AI助手以编程方式管理Jira问题。

特性

此服务器提供用于管理Jira问题的工具：

  • 创建新问题（任务、主题、子任务）
  • 列出可选状态筛选的问题
  • 更新现有问题（摘要、描述、状态）
  • 获取详细的问题信息
  • 删除问题
  • 为问题添加评论

设置

先决条件

  1. 具有API访问权限的Jira帐户
  2. Jira API令牌（可以从 Atlassian帐户设置)

安装

通过Smithery安装

通过以下方式自动安装Jira Server for Claude Desktop 史密瑟里:

npx -y @smithery/cli install jira-server --client claude

手动安装

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

配置

  1. 创建一个 .jira-config.json 工作目录中的文件：
{
  "projectKey": ["YOUR_PROJECT_KEY", "YOUR_OTHER_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": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token",
        "JIRA_DOMAIN": "your-domain"
      }
    }
  }
}

可用工具

创建_发行

创建新的Jira问题

  • 所需参数：
    • working_dir：包含.jira-config.json的目录
    • 摘要：问题标题
    • description:问题描述
    • 类型：问题类型（任务、史诗或子任务）

list_issues

列出项目中的问题

  • 所需参数：
    • working_dir：包含.jira-config.json的目录
  • 可选参数：
    • status：按状态筛选（例如，“待办事项”、“进行中”、“完成”）

update_issue

更新现有问题

  • 所需参数：
    • working_dir：包含.jira-config.json的目录
    • issue_key：问题密钥（例如PRJ-123）
  • 可选参数：
    • 摘要：新标题
    • description:新描述
    • 状态：新状态

获取问题

获取有关特定问题的详细信息

  • 所需参数：
    • working_dir：包含.jira-config.json的目录
    • issue_key：问题密钥（例如PRJ-123）

删除_问题

删除Jira问题

  • 所需参数：
    • working_dir：包含.jira-config.json的目录
    • issue_key：问题密钥（例如PRJ-123）

添加注释

向现有问题添加注释

  • 所需参数：
    • working_dir：包含.jira-config.json的目录
    • issue_key：问题密钥（例如PRJ-123）
    • comment：要添加的注释文本

发展

对于自动重建的开发：

npm run watch

错误处理

该服务器包括全面的错误处理功能，用于：

  • 项目密钥无效
  • 缺少配置
  • 问题类型无效
  • API身份验证错误
  • 状态转换无效

输出格式化

问题信息的格式包括：

  • 问题关键和总结
  • 问题类型和状态
  • 创建日期和创建者
  • 描述
  • 带有作者和时间戳的注释（如果有的话）

相关 MCP