Jira MCP Server

Jira MCP 服务

用于集成 Jira 的模型上下文协议（MCP）服务。此服务允许 Claude 等 AI 助手通过 MCP 与 Jira 交互。

作者： Samuel Rizzo

功能

• 列出所有 Jira 项目
• 获取问题的详细信息
• 按项目和经办人搜索问题
• 列出项目成员
• 检查用户的项目成员身份及其经办的问题
• 使用自定义字段创建问题
• 使用筛选选项列出和查询冲刺

安装

# Clone the repository
git clone https://github.com/samuelrizzo/jira-mcp-server.git
cd jira-mcp-server

# Install dependencies
npm install

# Build the project
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": "[email protected]",
        "JIRA_API_TOKEN": "your-api-token-here"
      }
    }
  }
}

设置 API 访问权限

1. 生成 Jira API 令牌：

   • 前往 Atlassian 账户设置
   • 点击“创建 API 令牌”
   • 为令牌命名，然后点击“创建”
   • 复制令牌（身份验证时需要使用）

2. 记下 Jira 主机 URL（例如 your-domain.atlassian.net）以及与 Atlassian 账户关联的电子邮件地址。

3. 将这些凭据添加到 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：（可选）问题类型（例如，'Task'、'Bug'、'Story'），默认为 'Task'
• assigneeName：（可选）被分配此问题的人员的显示名称
• reporterName：（可选）报告此问题的人员的显示名称
• sprintId：（可选）要将问题添加到的冲刺 ID
• jiraHost：你的 Jira 域名
• email：你的 Jira 邮箱
• apiToken：你的 Jira API 令牌

7. 列出冲刺（mcp_jira_list_sprints）

列出 Jira 中的当前冲刺，并提供筛选选项。

参数：

• boardId：（可选）用于按特定看板筛选冲刺的 Jira 看板 ID
• projectKey：（可选）用于查找与该项目关联的冲刺的项目键
• state：（可选）用于筛选的冲刺状态（active、future、closed 或 all），默认为 'active'
• jiraHost：你的 Jira 域名
• email：你的 Jira 邮箱
• apiToken：你的 Jira API 令牌

使用示例

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

"List all Jira projects in PROJECT"
"Get details for issue PROJECT-123"
"Search for issues assigned to John in PROJECT"
"List all members of PROJECT"
"Check what issues are assigned to Jane in PROJECT"
"Create a new bug issue titled 'Login page error' in PROJECT"
"List active sprints for PROJECT"

持续开发

此项目正在积极开发中。我们会定期添加新工具和功能，以扩展与 Jira 的集成能力。未来的更新将包括：

• 更多问题管理工具
• 冲刺和看板管理
• 高级搜索和筛选选项
• 自定义字段处理
• 工作流转换
• 以及更多！

关注或为代码仓库加星标，及时了解最新动态。

贡献

这是一个开源项目，欢迎大家贡献！参与贡献的步骤如下：

1. Fork 此代码仓库
2. 创建你的功能分支
3. 进行更改
4. 提交拉取请求

开源

此代码完全开源。你可以自由：

• 复制
• 修改
• 分发
• 用于商业用途
• 用于私人用途

没有任何限制——你可以随意使用此代码！

许可证

MIT