hybrid server

The server is able to function both locally and remotely, depending on the configuration or use case.

Integrations

Allows AI assistants to manage Jira issues programmatically, including creating, listing, updating, getting details, deleting issues, and adding comments.

Jira MCP 服务器

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

特征

该服务器提供管理 Jira 问题的工具：

创建新问题（任务、史诗、子任务）
列出具有可选状态过滤的问题
更新现有问题（摘要、描述、状态）
获取详细的问题信息
删除问题
对问题添加评论

设置

先决条件

具有 API 访问权限的 Jira 帐户
Jira API 令牌（可从Atlassian 帐户设置生成）

安装

安装依赖项：

npm install

构建服务器：

npm run build

配置

在您的工作目录中创建一个.jira-config.json文件：

{
  "projectKey": "YOUR_PROJECT_KEY"
}

使用您的 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 的目录
- 摘要：问题标题
- 描述：问题描述
- 类型：问题类型（任务、史诗或子任务）

列出问题

列出项目中的问题

必需参数：
- working_dir：包含 .jira-config.json 的目录
可选参数：
- 状态：按状态过滤（例如“待办”、“进行中”、“完成”）

更新问题

更新现有问题

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

获取问题

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

必需参数：
- 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）
- 评论：要添加的评论文本

发展

对于使用自动重建的开发：

npm run watch

错误处理

该服务器包括针对以下方面的全面错误处理：

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

输出格式

问题信息的格式包括：

问题关键和摘要
问题类型和状态
创建日期和创建者
描述
带有作者和时间戳的评论（如果有）

You must be authenticated.

A

security – no known vulnerabilities

F

license - not found

A

quality - confirmed to work

Tools

提供与 Jira 的 REST API 的集成，允许 AI 助手以编程方式管理 Jira 问题。

mcp-jira-server