MCP 服务器

Jira MCP Server

一个模型上下文协议（Model Context Protocol）服务器，它使像 Claude 这样的 AI 助手能够与 Jira 交互，从而允许通过自然语言查询执行项目管理任务，例如列出项目、搜索问题、创建工单和管理迭代。

README

Jira MCP 服务器

</div>

一个用于 Jira 集成的模型上下文协议 (MCP) 服务器。此服务器允许像 Claude 这样的 AI 助手使用 MCP 与 Jira 交互。

作者： Samuel Rizzo

</div>

功能

列出所有 Jira 项目
获取详细的问题信息
按项目和经办人搜索问题
列出项目成员
检查用户的项目成员资格和分配的问题
使用自定义字段创建新问题
列出和查询带有过滤选项的冲刺

安装

# 克隆仓库
git clone https://github.com/samuelrizzo/jira-mcp-server.git
cd jira-mcp-server

# 安装依赖
npm install

# 构建项目
npm run build

配置

MCP 服务器配置

将以下配置添加到您的 cursor/windsurf mcp 设置文件中：

{
  "mcpServers": {
    "jira-mcp": {
      "command": "node",
      "args": ["./dist/index.js"],
      "env": {
        "JIRA_HOST": "your-domain.atlassian.net",
        "JIRA_EMAIL": "your-email@example.com",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

设置 API 访问

生成 Jira API 令牌：
- 转到 Atlassian 帐户设置
- 单击“创建 API 令牌”
- 给它一个名称，然后单击“创建”
- 复制令牌（您将需要它进行身份验证）
记下您的 Jira 主机 URL（例如，your-domain.atlassian.net）和与您的 Atlassian 帐户关联的电子邮件地址。
将这些凭据添加到您的 MCP 服务器配置。

可用工具

1. 列出项目 (`mcp_jira_list_projects`)

列出经过身份验证的用户有权访问的所有 Jira 项目。

参数：

jiraHost: 您的 Jira 域名（例如，'your-domain.atlassian.net'）
email: 您的 Jira 电子邮件
apiToken: 您的 Jira API 令牌

2. 获取问题详情 (`mcp_jira_get_issue`)

检索有关特定 Jira 问题的详细信息。

参数：

issueKey: Jira 问题键（例如，'PROJECT-123'）
jiraHost: 您的 Jira 域名
email: 您的 Jira 电子邮件
apiToken: 您的 Jira API 令牌

3. 搜索问题 (`mcp_jira_search_issues`)

在特定项目中搜索问题，可以选择按经办人进行过滤。

参数：

projectKey: Jira 项目键
assigneeName: (可选) 按经办人姓名过滤问题
jiraHost: 您的 Jira 域名
email: 您的 Jira 电子邮件
apiToken: 您的 Jira API 令牌

4. 列出项目成员 (`mcp_jira_list_project_members`)

列出特定 Jira 项目的所有成员。

参数：

projectKey: Jira 项目键
jiraHost: 您的 Jira 域名
email: 您的 Jira 电子邮件
apiToken: 您的 Jira API 令牌

5. 检查用户问题 (`mcp_jira_check_user_issues`)

检查用户是否是项目的成员，并列出他们分配的问题。

参数：

projectKey: Jira 项目键
userName: 要检查的用户的显示名称
jiraHost: 您的 Jira 域名
email: 您的 Jira 电子邮件
apiToken: 您的 Jira API 令牌

6. 创建问题 (`mcp_jira_create_issue`)

在 Jira 项目中创建具有指定详细信息的新问题。

参数：

projectKey: Jira 项目键
summary: 问题的标题/摘要
description: 问题的详细描述
issueType: (可选) 问题类型（例如，“任务”、“错误”、“故事”），默认为“任务”
assigneeName: (可选) 要将问题分配给的人员的显示名称
reporterName: (可选) 报告问题的人员的显示名称
sprintId: (可选) 要将问题添加到其中的冲刺的 ID
jiraHost: 您的 Jira 域名
email: 您的 Jira 电子邮件
apiToken: 您的 Jira API 令牌

7. 列出冲刺 (`mcp_jira_list_sprints`)

列出 Jira 中当前的冲刺，并带有过滤选项。

参数：

boardId: (可选) Jira 看板 ID，用于按特定看板过滤冲刺
projectKey: (可选) 项目键，用于查找与项目关联的冲刺
state: (可选) 要过滤的冲刺状态（活动、未来、已关闭或全部），默认为“活动”
jiraHost: 您的 Jira 域名
email: 您的 Jira 电子邮件
apiToken: 您的 Jira API 令牌

使用示例

以下是一些您可以与 Claude 一起使用的示例查询：

"列出 PROJECT 中的所有 Jira 项目"
"获取问题 PROJECT-123 的详细信息"
"搜索 PROJECT 中分配给 John 的问题"
"列出 PROJECT 的所有成员"
"检查 PROJECT 中分配给 Jane 的问题"
"在 PROJECT 中创建一个标题为“登录页面错误”的新错误问题"
"列出 PROJECT 的活动冲刺"